| Thread Previous • Date Previous • Date Next • Thread Next |
Kevin,this concerns me quite a bit b/c this resource will be housed as an online resource and I can see many folks wanting to simply cut and paste from the text. I know this only affects raw source and not the final output it seems like an extra (unnecessary) step to have to edit all the source for this markup technique. I would rather use the verbatim or something else rather than forcing authors and markup folks to have to alter code samples. I think this introduces too many opportunities for errors in the process.
Belinda On 01/15/2011 05:28 PM, Kevin Godby wrote:
Hello, everyone.
I've redefined the pipe symbol (|) to delimit inline code. This means
that instead of writing:
First, we will initialize the \lstinline|x| and \lstinline|y| variables to 0.
you can write:
First, we will initialize the |x| and |y| variables to 0.
I think the benefits of that are fairly obvious. :)
One downside though, is that you can no longer use the pipe like this:
\prompt \userinput{ls | less} % this won't work any more!
Instead, you must use the \textpipe command:
\prompt \userinput{ls \textpipe\ less} % works again
Also note the \ after the \textpipe command. This<backslash><space>
forces LaTeX to insert a white space after the pipe. Another way of
ensuring the proper spacing is to add an empty set of braces after the
\textpipe command:
\prompt \userinput{ls \textpipe{} less} % also works
The only place in the manual where we're currently using the pipe is
in the bzr chapter. I've already made the necessary changes there.
(Apologies for any conflicts, Kyle!)
Please let me know if you have any questions.
--Kevin _______________________________________________ Mailing list: https://launchpad.net/~ubuntu-developer-manual Post to : ubuntu-developer-manual@xxxxxxxxxxxxxxxxxxx Unsubscribe : https://launchpad.net/~ubuntu-developer-manual More help : https://help.launchpad.net/ListHelp
Education Canonical belinda.lopez@xxxxxxxxxxxxx dinda@xxxxxxxxxx IRC: dinda Office: Galveston, Texas -- Ubuntu - Linux for Human Beings http://www.ubuntu.com http://www.edubuntu.org http://www.canonical.com ---------------------------
| Thread Previous • Date Previous • Date Next • Thread Next |
