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>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
Message-ID:  <501AA54D.6090301@morningstar2.co.uk>
Date:         Thu, 2 Aug 2012 17:05:33 +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:  <501AA3AA.5000400@gmail.com>
Precedence: list
Status: R

On 02/08/2012 16:58, Joel C. Salomon wrote:
> See this MWE:
> 
> \documentclass[full]{l3doc}
> 
> \title{An \pkg{l3doc} bug}
> \author{Joel C. Salomon}
> 
> \begin{document}
> \maketitle
> 
> \begin{documentation}
> 
> \begin{function}{\some_function_with_a_very_long_name:nnnnn}
>   \begin{syntax}
>     "\some_function_with_a_very_long_name:nnnnn" <first argument>
> <second argument> <third argument> <fourth argument> <fifth argument>
>     "\some_function_with_a_very_long_name:nnnnn"
>       <first argument> <second argument> <third argument> <fourth argument>
>       <fifth argument>
>     "\some_function_with_a_very_long_name:nnnnn" %
>        <first argument> <second argument> <third argument> <fourth
> argument> %
>        <fifth argument>
>   \end{syntax}
>   Notice how the first line is very very long in the source,
>   but when I split it up, the split is reflected in the output.
>   Adding comments just makes things worse.
> \end{function}
> \end{documentation}
> 
> \end{document}

I suspect Will is going to say 'not a bug'. You'll notice in the sources
we use only one line, which is deliberate.
-- 
Joseph Wright