This is the mail archive of the
gdb-patches@sourceware.cygnus.com
mailing list for the GDB project.
Re: patch for gdb.texinfo
- To: eliz at delorie dot com
- Subject: Re: patch for gdb.texinfo
- From: Dmitry Sivachenko <dima at Chg dot RU>
- Date: Sun, 30 Jan 2000 21:09:34 +0300 (MSK)
- Cc: gdb-patches at sourceware dot cygnus dot com
> Dmitry Sivachenko writes:
>
> > > Why is it a good idea to remove the @dfn here?
> >
> > Because there is no definition of 'dynamic arrays' here in the text.
>
> @dfn is not only for something that is being defined. Here's what the
> Texinfo manual says:
>
> Use the `@dfn' command to identify the introductory or defining use
> of a technical term. Use the command only in passages whose purpose is
> to introduce a term which will be used again or which the reader ought
> to know. Mere passing mention of a term for the first time does not
> deserve @dfn.
>
> This doesn't seem to be limited to text that defines a term. It does
> say that if the term is never to be used again, it doesn't deserve a
> @dfn. OTOH, if ``dynamic arrays'' aren't mentioned anywhere else,
> then why was it important to mention them here? Perhaps it should be
> removed altogether.
Yes, it is just a mention of 'dynamic arrays' there. So we should exclude
any emphasis there. But we may leave the words 'dynamic array', because
it is well known what it means...
--dima