User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.7; rv:14.0)
            Gecko/20120713 Thunderbird/14.0
MIME-Version: 1.0
References: <501AA3AA.5000400@gmail.com> <501AA936.9050205@morningstar2.co.uk> 
            <CANQYN6zoBtCmA2QczWY6Y4+3AvKUQKaNRX0QWtdhKePpbVWKtQ@mail.gmail.com>           
            <CAFUtaNH9ObvaskLSgvxhGS8we2NjwzE2h2dirJHBzAtSML51VQ@mail.gmail.com>           
            <CANQYN6w8Qs=qd6ey6+0wv0q6LN8K4QRByTvn62d8EyZ8OpPOZQ@mail.gmail.com>
            <4453C269-8281-443D-A548-C9B49B4E37B4@gmail.com>
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
Message-ID:  <501E3630.1060607@morningstar2.co.uk>
Date:         Sun, 5 Aug 2012 10:00:32 +0100
Reply-To: Mailing list for the LaTeX3 project
              <LATEX-L@listserv.uni-heidelberg.de>
Sender: Mailing list for the LaTeX3 project <LATEX-L@listserv.uni-heidelberg.de>
From: Joseph Wright <joseph.wright@MORNINGSTAR2.CO.UK>
Subject: Re: l3doc bug in syntax sections
To: LATEX-L@listserv.uni-heidelberg.de
In-Reply-To:  <4453C269-8281-443D-A548-C9B49B4E37B4@gmail.com>
Precedence: list
Status: R

On 05/08/2012 05:16, Will Robertson wrote:
> On 03/08/2012, at 9:53 PM, Bruno Le Floch wrote:
> 
>> Admittedly, none of the three "solutions" is great.  As Joseph notes,
>> we've gone for a single line in the l3 source.  We could perhaps add
>> \def\^^M{\unskip\space\ignorespaces} to the \begin{syntax} setup: this
>> would allow
>>
>>    \cs{some_function_with_a_very_long_name:nnnnn} \
>>      \Arg{first argument} \Arg{second argument} \
>>      \Arg{third argument} \Arg{fourth argument} \
>>      \Arg{fifth argument}
> 
> I've been thinking for a while that having \obeylines in the syntax environment (which predates my involvement on this code IIRC) has made certain things rather awkward.
> 
> It would be an annoying change to have to implement in our sources, but what do you think about dropping \obeylines?
> 
> -- Will
Seems sensible to me: we've altered how we approach using this
environment, and \obeylines is probably not that helpful.
--
Joseph Wright