FW: [Gdb-discuss] Style Conventions for Documentation?

Mann, Benjamin (Jr) ben.mann@hp.com
Wed Jun 9 16:27:00 GMT 2004


Can you help me out?  I am looking for style convention information used
in the GNU documentation, if such guidelines exist. 

Jim Blandy recommended I submit the query to you. If there's a better,
more appropriate way to find the information I seek, please let me know.

See my message (and Jim's reply) below.

Thank you.

Ben Mann, Jr.
Hewlett-Packard Company
110 Spit Brook Road
Nashua, NH  03062
e-mail: Ben.Mann@hp.com
telephone: 603-884-3477

-----Original Message-----
From: jimb@zenia.home [mailto:jimb@zenia.home] On Behalf Of Jim Blandy
Sent: June 09, 2004 12:16 PM
To: Mann, Benjamin (Jr)
Cc: gdb-discuss@gnu.org
Subject: Re: [Gdb-discuss] Style Conventions for Documentation?

"Mann, Benjamin (Jr)" <ben.mann@hp.com> writes:
> I am a technical editor who has been asked to review the HP WDB 
> version of Debugging with GDB.  Please forgive my ignorance of 
> information that may be readily available; this is my first exposure 
> to open source documentation.  I have been unable to find any 
> guidelines or reference information on your Web site about the 
> preferred writing style and typographic conventions for GNU-related 
> documentation.
> Do you have, or know where I might find, a listing of typographic
> conventions that are recommended for use in the documentation?
> there have been many contributors to the documentation (from many 
> companies and with different points of view), many styles are 
> implemented for similar items.  For example, sometimes command options

> are in single quotes, sometimes not.  Or lead-ins to lists or code 
> examples sometimes end with a colon, sometimes with no punctuation, 
> and sometimes with a period.
> As an editor I value consistency (among other things like clear 
> writing, conciseness, and so forth), so I am looking for any guidance 
> about writing style preferences you have or know of, if any.
> Thank you for any direction you can provide.

Probably the best place to post this question would be
gdb@sources.redhat.com.  Eli Zaretskii <eliz@elta.co.il> is our
documentation maintainer; he's listed in gdb/MAINTAINERS.

More information about the Gdb mailing list