From: Martin Stromberg <Martin DOT Stromberg AT lu DOT erisoft DOT se>
Message-Id: <200009041037.MAA03506@lws256.lu.erisoft.se>
Subject: Re: Doc for __dosexec_find_on_path()
To: djgpp-workers AT delorie DOT com
Date: Mon, 4 Sep 2000 12:37:49 +0200 (MET DST)
In-Reply-To: <Pine.SUN.3.91.1000903081819.24880H-100000@is> from "Eli Zaretskii" at Sep 03, 2000 08:39:44 AM
X-Mailer: ELM [version 2.5 PL3]
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Reply-To: djgpp-workers AT delorie DOT com
Errors-To: nobody AT delorie DOT com
X-Mailing-List: djgpp-workers AT delorie DOT com
X-Unsubscribes-To: listserv AT delorie DOT com
Precedence: bulk

Eli said:
> There's no automatic line breaks inside @example.  So breaking long lines 
> by hand is a Good Thing.
> 
> In fact, most of the library's .txh files need to be fixed like that: 
> many Description sections overflow the page margins when a printable 
> version of the reference is produced.  I think that every @example in the 
> Description section should be replaced with @smallexample (with a 
> suitable change to "@end example"), and then the lines which are longer 
> than 60 characters should be broken into multiple lines.
> 
> So I'd like to ask everybody who changes or adds documentation to please 
> take care of this issue as well.

I'm not sure I understand. 

1. @example -> @smallexample

2. break lines at 60 characters

Should we do 1 or 2 or (1 and 2)?


Right,

						MartinS