From mboxrd@z Thu Jan 1 00:00:00 1970 From: Michael Meissner To: "J.T. Conklin" Cc: Stan Shebs , gdb@sourceware.cygnus.com Subject: Re: Merging manuals (was Re: How do you use GDB to debug GDB) Date: Wed, 21 Mar 2001 15:59:00 -0000 Message-id: <20010320194357.F14737@cse.cygnus.com> References: <3AB78AA3.A534B844@cygnus.com> <3AB7B697.CBAF2099@apple.com> <5melvs7ywm.fsf@jtc.redback.com> X-SW-Source: 2001-03/msg00215.html On Tue, Mar 20, 2001 at 04:23:37PM -0800, J.T. Conklin wrote: > >>>>> "Stan" == Stan Shebs writes: > >> As a complete asside, it has also been suggested that the two documents > >> be merged. From memory GCC did this. > > Stan> GCC still works this way. GDB has it as a separate document > Stan> because that's how John Gilmore set it up, and although I wasn't > Stan> there, I bet Roland Pesch, as the only professional tech writer > Stan> at Cygnus at the time, strongly objected to gluing the internals > Stan> documentation into the user manual. (Probably the same way > Stan> would have happened to GCC if he'd had any input into GCC docs.) > > Stan> I've thought about merging them from time to time. The main > Stan> argument against merging should be obvious; the user manual is > Stan> just that, and should not include anything that might mislead or > Stan> intimidate users. > > I think the split users/internals manuals is a good thing. I've seen > the puzzled expressions of folks when encountering the gcc manual for > the first time. They were quite relieved when they learned that they > didn't have to learn about all that stuff just to use the compiler. Note, in the case of the GCC manual, you really can't use the extended asm extension, without knowing what the valid constraint letters are, and those of course are in the implementation section. -- Michael Meissner, Red Hat, Inc. (GCC group) PMB 198, 174 Littleton Road #3, Westford, Massachusetts 01886, USA Work: meissner@redhat.com phone: +1 978-486-9304 Non-work: meissner@spectacle-pond.org fax: +1 978-692-4482