[evolution-patches] Re: Patch to remove distro-specific references in Evolution docs

[Shaun McCance <shaunm gnome org>]

On Wed, 2005-03-09 at 15:54 -0500, Dave Malcolm wrote:
>(Cross-posting to evolution-patches and to gnome-doc-list)
>
>Attached is a first-pass at a patch to the Evolution documentation. 
>Doesn't yet have a ChangeLog since I'd like feedback from the Evolution
>and GNOME docs people.

[snip]

I'll leave the Novell folks to decide on that stuff, but I do
think it would be good to make our docs more easily customizable
by vendors.

>If distributions want to make minor patches to these entities, can
>they?  The GNU FDL appears to impose some onerous restrictions on doing
>Modified Versions; in particular, it looks like we'd need to create a
>History section.  Also, for me (albeit on the increasingly ancient yelp
>2.6) the legal info doesn't render properly, which is a bit of an issue
>if it must be preserved verbatim.  This may apply to translators as
>well.  Usual disclaimers apply; I am not a lawyer.

The revhistory should satisfy the history of the GFDL.  At least,
we consider it to satisfy it for Gnome docs, and the intent of the
copyright holder is golden.

As for the legal info, you're not publishing the Yelp rendering.
You, as the author, are publishing a DocBook file, and you have
maintained the legal info verbatim.  You're hardly at fault if
somebody views the document in an application that doesn't render
it properly.

>Some stylistic questions regarding markup: how do the maintainers feel
>about me adding <guimenu>/<guimenuitem> tags where appropriate?  How
>about me adding an entity for the separator for these?  Is there policy
>for this within the GNOME documentation team?

Menus and menu items should absolutely be inside <guimenu> and
<guimenuitem>.  And there's no need to specify a seperator, or
even use one.  That's what <menuchoice> is for.

--
Shaun