MIME-Version: 1.0
References: <501AA3AA.5000400@gmail.com> <501AA936.9050205@morningstar2.co.uk>
            <CANQYN6zoBtCmA2QczWY6Y4+3AvKUQKaNRX0QWtdhKePpbVWKtQ@mail.gmail.com>
            <CAFUtaNH9ObvaskLSgvxhGS8we2NjwzE2h2dirJHBzAtSML51VQ@mail.gmail.com>
Content-Type: text/plain; charset=ISO-8859-1
Message-ID:  <CANQYN6w8Qs=qd6ey6+0wv0q6LN8K4QRByTvn62d8EyZ8OpPOZQ@mail.gmail.com>
Date:         Fri, 3 Aug 2012 14:23:44 +0200
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: Bruno Le Floch <blflatex@GMAIL.COM>
Subject: Re: l3doc bug in syntax sections
To: LATEX-L@listserv.uni-heidelberg.de
In-Reply-To:  <CAFUtaNH9ObvaskLSgvxhGS8we2NjwzE2h2dirJHBzAtSML51VQ@mail.gmail.com>
Precedence: list
Status: R

> The result is the same; there's an unsightly large gap between the
> stuff on the first line before the comment marker (whether % or ^^A)
> and what's on the following line. [I'd actually noticed this first in
> a .dtx file, but used normal LaTeX syntax here for ease of
> illustration.]

Sorry, I shamefully hadn't compiled your MWE.  Here are three ways to go:

- Use the primitive \ignorespaces (in the syntax environment, active
spaces expand to normal spaces IIRC), and comment out the
end-of-lines.

- Comment the end-of-line and start the next line directly at column 0.

- Split the arguments in the output, since they don't fit in a line anyways.

  \begin{syntax}
    \cs{some_function_with_a_very_long_name:nnnnn} \ignorespaces %
      \Arg{first argument} \Arg{second argument} \ignorespaces %
      \Arg{third argument} \Arg{fourth argument} \Arg{fifth argument}

    \cs{some_function_with_a_very_long_name:nnnnn} %
\Arg{first argument} \Arg{second argument} \Arg{third argument} %
\Arg{fourth argument} \Arg{fifth argument}

    \cs{some_function_with_a_very_long_name:nnnnn}
    ~~\Arg{first argument} \Arg{second argument} \Arg{third argument}
    ~~\Arg{fourth argument} \Arg{fifth argument}
  \end{syntax}

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}

Regards,
Bruno