diff --git a/lib/doc/Extended.lyx b/lib/doc/Extended.lyx index 05ec28eb07..06d9379d03 100644 --- a/lib/doc/Extended.lyx +++ b/lib/doc/Extended.lyx @@ -1,5 +1,5 @@ #LyX 2.0.0svn created this file. For more info see http://www.lyx.org/ -\lyxformat 361 +\lyxformat 362 \begin_document \begin_header \textclass scrbook @@ -146,11 +146,7 @@ status collapsed \begin_layout Plain Layout \noindent -< -lyx --docs@lists. -lyx -.org> + \end_layout \end_inset @@ -190,12 +186,9 @@ User's Guide features one needs to know in order to prepare most documents. However, the LyX Team has worked to LyX extensible through various configuratio n files and external packages. - That means that if you want to support the -Fizzwizzle - -LaTeX - package, you can create a layout file (or module) for it without having - to alter LyX itself. + That means that if you want to support the Fizzwizzle LaTeX package, you + can create a layout file (or module) for it without having to alter LyX + itself. We've already had contributions of several new features this way. This is the place where all of those get documented. \end_layout @@ -203,21 +196,13 @@ LaTeX \begin_layout Standard This manual also documents some special features, like fax support, version control, and SGML support, which require additional software to work properly. - Lastly, there's a chapter of -LaTeX - tools and tips, things you can use to spruce up your documents by directly - using the powerful features of -LaTeX -. + Lastly, there's a chapter of LaTeX tools and tips, things you can use to + spruce up your documents by directly using the powerful features of LaTeX. After all, LyX \emph on is \emph default - only -WYSIWYM - and will only ever interface to some, not all, -LaTeX - features. + only WYSIWYM and will only ever interface to some, not all, LaTeX features. \end_layout \begin_layout Standard @@ -241,38 +226,25 @@ User's Guide \begin_layout Standard Since all the topics in this manual depend heavily on LyX's interaction - with -LaTeX -, this first chapter covers the inner workings of LyX and how to direct - LyX to generate exactly the -LaTeX - code you want. + with LaTeX, this first chapter covers the inner workings of LyX and how + to direct LyX to generate exactly the LaTeX code you want. It is obviously for more seasoned LyX users. \end_layout \begin_layout Chapter -LyX and -LaTeX +LyX and LaTeX \end_layout \begin_layout Section -How LyX Uses -LaTeX +How LyX Uses LaTeX \end_layout \begin_layout Standard -This chapter is for both TeX- -nicians - and the -LaTeX --curious. - In it, we'll explain how LyX and -LaTeX - work together to produce printable output. +This chapter is for both TeX-nicians and the LaTeX-curious. + In it, we'll explain how LyX and LaTeX work together to produce printable + output. This is the only place in any of the manuals where we assume you know something - about -LaTeX -. + about LaTeX. \end_layout \begin_layout Standard @@ -280,49 +252,24 @@ At one time, LyX was called a \begin_inset Quotes eld \end_inset - -WYSIWYM - -frontend - to -LaTeX -, +WYSIWYM frontend to LaTeX, \begin_inset Quotes erd \end_inset but that's no longer true. - There are -frontends - to -LaTeX - out there. + There are frontends to LaTeX out there. \begin_inset Foot status collapsed \begin_layout Plain Layout -Some -familar - ones are -TeXmaker - and -kile -, on Linux, and -TeXshop -, -OSX -. - There are also the -LaTeX - modes for vi and -emacs -, of course. +Some familar ones are TeXmaker and kile, on Linux, and TeXshop, OSX. + There are also the LaTeX modes for vi and emacs, of course. \end_layout \end_inset - These are basically text editors with the ability to run -LaTeX - and mark any errors in the file you're editing. + These are basically text editors with the ability to run LaTeX and mark + any errors in the file you're editing. Although LyX \emph on is @@ -331,22 +278,16 @@ is \emph on does \emph default - run -LaTeX -, and it also indicates errors in the file, it also does much, much more. - For one thing, you don't need to know -LaTeX - to use LyX effectively. - And LyX has added its own extensions to -LaTeX -. + run LaTeX, and it also indicates errors in the file, it also does much, + much more. + For one thing, you don't need to know LaTeX to use LyX effectively. + And LyX has added its own extensions to LaTeX. Try the following sometime: select \begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout Export\SpecialChar \menuseparator - LaTeX \end_layout @@ -378,8 +319,7 @@ Source status collapsed \begin_layout Plain Layout -. -tex +.tex \end_layout \end_inset @@ -391,9 +331,7 @@ tex \end_layout \begin_layout Standard -There are several commands that automatically invoke -LaTeX -. +There are several commands that automatically invoke LaTeX. They are: \end_layout @@ -455,30 +393,22 @@ Fax \end_layout \begin_layout Standard -They will only invoke -LaTeX - if the file has changed since the last time -LaTeX - was run. +They will only invoke LaTeX if the file has changed since the last time + LaTeX was run. \end_layout \begin_layout Standard -When LyX runs -LaTeX - on the file you're editing, it performs these steps: +When LyX runs LaTeX on the file you're editing, it performs these steps: \end_layout \begin_layout Enumerate -Convert the document to -LaTeX - and save to a file with the extension +Convert the document to LaTeX and save to a file with the extension \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -. -tex +.tex \end_layout \end_inset @@ -488,8 +418,7 @@ tex status collapsed \begin_layout Plain Layout -. -lyx +.lyx \end_layout \end_inset @@ -498,15 +427,12 @@ lyx \end_layout \begin_layout Enumerate -Run -LaTeX - on the +Run LaTeX on the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -. -tex +.tex \end_layout \end_inset @@ -516,7 +442,6 @@ tex status collapsed \begin_layout Plain Layout - bibtex \end_layout @@ -527,15 +452,12 @@ bibtex status collapsed \begin_layout Plain Layout - makeindex \end_layout \end_inset -) needed to compile the -LaTeX - file. +) needed to compile the LaTeX file. \end_layout \begin_layout Enumerate @@ -543,9 +465,7 @@ If there are any errors, show the error log. \end_layout \begin_layout Standard -If you've run -LaTeX - using +If you've run LaTeX using \begin_inset Flex CharStyle:MenuItem status collapsed @@ -560,11 +480,7 @@ DVI \end_inset -, LyX then runs a -DVI - viewer to display the -DVI --file. +, LyX then runs a DVI viewer to display the DVI-file. If you've used \begin_inset Flex CharStyle:MenuItem status collapsed @@ -589,36 +505,26 @@ Run status collapsed \begin_layout Plain Layout - dvips \end_layout \end_inset - to convert the -DVI - file to -PostScript -. + to convert the DVI file to PostScript. \end_layout \begin_layout Itemize -Run a -PostScript - viewer, such as +Run a PostScript viewer, such as \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - ghostview \end_layout \end_inset -, to display the -PostScript - file. +, to display the PostScript file. \end_layout \begin_layout Standard @@ -626,22 +532,17 @@ LyX does similar things when viewing, or exporting, other formats. \end_layout \begin_layout Section -Translating -LaTeX - files into LyX +Translating LaTeX files into LyX \end_layout \begin_layout Standard -You can import a -LaTeX - file into LyX by using the +You can import a LaTeX file into LyX by using the \begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout File\SpecialChar \menuseparator Import\SpecialChar \menuseparator - LaTeX \end_layout @@ -653,7 +554,6 @@ LaTeX status collapsed \begin_layout Plain Layout - tex2lyx \end_layout @@ -664,8 +564,7 @@ tex2lyx status collapsed \begin_layout Plain Layout -foo. -lyx +foo.lyx \end_layout \end_inset @@ -675,8 +574,7 @@ lyx status collapsed \begin_layout Plain Layout -foo. -tex +foo.tex \end_layout \end_inset @@ -691,7 +589,6 @@ status collapsed status collapsed \begin_layout Plain Layout - tex2lyx \end_layout @@ -710,22 +607,18 @@ tex2lyx status collapsed \begin_layout Plain Layout - tex2lyx \end_layout \end_inset - will translate most legal -LaTeX -, but not everything. + will translate most legal LaTeX, but not everything. It will put things it doesn't understand into TeX code, so after translating a file with \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - tex2lyx \end_layout @@ -749,16 +642,11 @@ Inserting TeX Code into LyX Documents \end_layout \begin_layout Standard -Anything you can do in -LaTeX - you can do in LyX, for a very simple reason: You can always insert TeX - code into any LyX document. - LyX cannot, and will never be able to, display every possible -LaTeX - construct. - If ever you need to insert -LaTeX - commands into your LyX document, you can use the +Anything you can do in LaTeX you can do in LyX, for a very simple reason: + You can always insert TeX code into any LyX document. + LyX cannot, and will never be able to, display every possible LaTeX construct. + If ever you need to insert LaTeX commands into your LyX document, you can + use the \begin_inset Flex CharStyle:Code status collapsed @@ -783,9 +671,7 @@ TeX Code \end_layout \begin_layout Standard -Here's an example of inserting -LaTeX - commands in a LyX document. +Here's an example of inserting LaTeX commands in a LyX document. The code looks like this: \end_layout @@ -798,17 +684,11 @@ begin{tabular}{ll} \backslash -begin{ -minipage -}{ -5cm -} +begin{minipage}{5cm} \begin_inset Newline newline \end_inset -This is an example for a -minipage - environment. +This is an example for a minipage environment. You \begin_inset Newline newline \end_inset @@ -824,9 +704,7 @@ figures and tables. \backslash -end{ -minipage -} +end{minipage} \begin_inset Newline newline \end_inset @@ -836,11 +714,7 @@ minipage \backslash -begin{ -minipage -}{ -5cm -} +begin{minipage}{5cm} \begin_inset Newline newline \end_inset @@ -852,11 +726,7 @@ begin{verbatim} \backslash -begin{ -minipage -}{ -5cm -} +begin{minipage}{5cm} \begin_inset Newline newline \end_inset @@ -867,9 +737,7 @@ This ... \backslash -end{ -minipage -} +end{minipage} \begin_inset Newline newline \end_inset @@ -881,9 +749,7 @@ end{verbatim} \backslash -end{ -minipage -} +end{minipage} \begin_inset Newline newline \end_inset @@ -1011,9 +877,7 @@ end{tabular} \begin_layout Standard In addition to using TeX code, you can also create a separate file containing - some complex -LaTeX - structure and then use + some complex LaTeX structure and then use \begin_inset Flex CharStyle:MenuItem status collapsed @@ -1044,8 +908,7 @@ Input status collapsed \begin_layout Plain Layout -. -tex +.tex \end_layout \end_inset @@ -1055,9 +918,7 @@ tex know \emph default works already. - Otherwise, you'll have a big job tracking down -LaTeX - errors. + Otherwise, you'll have a big job tracking down LaTeX errors. \end_layout \begin_layout Standard @@ -1069,9 +930,7 @@ LyX \emph on does not \emph default - check if your -LaTeX - code is correct. + check if your LaTeX code is correct. \end_layout \begin_layout Itemize @@ -1083,12 +942,8 @@ On that last point, LyX does have quite a few features tucked into it, and more are coming. Be sure to check the manuals to make sure that LyX doesn't have such-and-such feature before you decide you have to do it by hand. - Moreover, there are numerous -LaTeX - packages out there to do all sorts of things, from labels to envelopes - to fancy -multipage - tables. + Moreover, there are numerous LaTeX packages out there to do all sorts of + things, from labels to envelopes to fancy multipage tables. Check out \begin_inset CommandInset href LatexCommand href @@ -1109,9 +964,7 @@ reference "cha:secrets" \begin_layout Standard If you do need to do some wild and fancy things within your document, be - sure to check out a good -LaTeX - book for assistance. + sure to check out a good LaTeX book for assistance. There are a number of them listed in the bibliography of the \emph on User's Guide @@ -1120,35 +973,25 @@ User's Guide \end_layout \begin_layout Section -LyX and the -LaTeX - Preamble +LyX and the LaTeX Preamble \end_layout \begin_layout Subsection -About the -LaTeX - Preamble +About the LaTeX Preamble \end_layout \begin_layout Standard -If you already know -LaTeX -, there is no need to explain here what the preamble is good for. +If you already know LaTeX, there is no need to explain here what the preamble + is good for. If you don't, the following will give you some ideas—we recommend again - that you consult a -LaTeX - book for further information. + that you consult a LaTeX book for further information. In any case, you should read the points below, because they explain what - you can do and what you don't need to do in the -LaTeX - preamble of a LyX document. + you can do and what you don't need to do in the LaTeX preamble of a LyX + document. \end_layout \begin_layout Standard -The -LaTeX - preamble comes at the very beginning of a document, +The LaTeX preamble comes at the very beginning of a document, \emph on before \emph default @@ -1163,11 +1006,8 @@ Declare the document class. \end_inset LyX already does this for you. - If you're a seasoned -LaTeX -- -nician -, and you have a custom document class you want to use, check out the + If you're a seasoned LaTeX-nician, and you have a custom document class + you want to use, check out the \emph on Customization Manual \emph default @@ -1180,16 +1020,13 @@ Declare the usage of packages. \begin_inset Newline newline \end_inset - -LaTeX - packages provide special commands, which are only available within a document - when the package has been declared in the preamble. +LaTeX packages provide special commands, which are only available within + a document when the package has been declared in the preamble. For example, the package \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - indentfirst \end_layout @@ -1206,9 +1043,7 @@ Set counters, variables, lengths and widths. \begin_inset Newline newline \end_inset -There are several -LaTeX - counters and variables which +There are several LaTeX counters and variables which \emph on must \emph default @@ -1228,7 +1063,6 @@ status collapsed \begin_layout Plain Layout \backslash - newcommand \end_layout @@ -1241,7 +1075,6 @@ status collapsed \begin_layout Plain Layout \backslash - renewcommand \end_layout @@ -1251,17 +1084,15 @@ renewcommand \begin_inset Newline newline \end_inset -These are abbreviations for -LaTeX - commands which appear very often inside a document. +These are abbreviations for LaTeX commands which appear very often inside + a document. Although the preamble is a good place to declare such commands, they \emph on can \emph default be declared anywhere (before they are used for the first time, of course). - This can be useful if there is a lot of raw -LaTeX - code in your document, which normally should not be the case. + This can be useful if there is a lot of raw LaTeX code in your document, + which normally should not be the case. \end_layout \begin_layout Standard @@ -1270,16 +1101,13 @@ LyX adds its own set of definitions to the preamble of the status collapsed \begin_layout Plain Layout -. -tex +.tex \end_layout \end_inset file it produces. - This makes -LaTeX - files generated by LyX portable. + This makes LaTeX files generated by LyX portable. \end_layout \begin_layout Subsection @@ -1287,17 +1115,14 @@ Changing the Preamble \end_layout \begin_layout Standard -The commands which LyX adds to the preamble of a -LaTeX - file are fixed; you can't change them without patching LyX itself. +The commands which LyX adds to the preamble of a LaTeX file are fixed; you + can't change them without patching LyX itself. You can, however, add your own stuff to the preamble by selecting \begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout - LaTeX - \begin_inset space ~ \end_inset @@ -1375,16 +1200,13 @@ Example #1: Offsets \end_layout \begin_layout Standard -There are two variables under -LaTeX - that control page position: +There are two variables under LaTeX that control page position: \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout \backslash - hoffset \end_layout @@ -1397,7 +1219,6 @@ status collapsed \begin_layout Plain Layout \backslash - voffset \end_layout @@ -1415,7 +1236,6 @@ status collapsed \begin_layout Plain Layout \backslash - hoffset \end_layout @@ -1428,7 +1248,6 @@ status collapsed \begin_layout Plain Layout \backslash - voffset \end_layout @@ -1445,7 +1264,6 @@ status collapsed \begin_layout Plain Layout \backslash - hoffset \end_layout @@ -1458,7 +1276,6 @@ status collapsed \begin_layout Plain Layout \backslash - voffset \end_layout @@ -1477,21 +1294,16 @@ g. \end_inset the page isn't shifted. - Unfortunately, some -DVI - drivers always seem to shift the page. + Unfortunately, some DVI drivers always seem to shift the page. We have no idea why, or why the sysadmin hasn't fixed such behavior. If you're using LyX on a system that you don't personally maintain, and - your sysadmin is a -doofus -, + your sysadmin is a doofus, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout \backslash - hoffset \end_layout @@ -1504,7 +1316,6 @@ status collapsed \begin_layout Plain Layout \backslash - voffset \end_layout @@ -1522,25 +1333,17 @@ inches too big. \begin_layout LyX-Code \backslash - -setlength -{ +setlength{ \backslash - -hoffset -}{-0.5 in} +hoffset}{-0.5 in} \end_layout \begin_layout LyX-Code \backslash - -setlength -{ +setlength{ \backslash - -voffset -}{-0.5 in} +voffset}{-0.5 in} \end_layout \begin_layout Standard @@ -1553,9 +1356,8 @@ Example #2: Labels \begin_layout Standard Speaking of labels, suppose you wanted to print out a bunch of address labels. - There's a rather nice package, available at your nearest -CTAN - archive, for printing sheets of labels: + There's a rather nice package, available at your nearest CTAN archive, + for printing sheets of labels: \begin_inset Flex CharStyle:Code status collapsed @@ -1592,70 +1394,49 @@ article \begin_layout LyX-Code \backslash - -usepackage -{labels} +usepackage{labels} \end_layout \begin_layout LyX-Code \backslash - -LabelCols -=3 +LabelCols=3 \end_layout \begin_layout LyX-Code \backslash - -LabelRows -=7 +LabelRows=7 \end_layout \begin_layout LyX-Code \backslash - -LeftBorder -= -8mm +LeftBorder=8mm \end_layout \begin_layout LyX-Code \backslash - -RightBorder -= -8mm +RightBorder=8mm \end_layout \begin_layout LyX-Code \backslash - -TopBorder -= -9mm +TopBorder=9mm \end_layout \begin_layout LyX-Code \backslash - -BottomBorder -= -2mm +BottomBorder=2mm \end_layout \begin_layout Standard -This sets things up for Avery label sheets, stock # -5360 -. - You're now ready to print labels, but you'll need to insert -LaTeX - code, placing the commands +This sets things up for Avery label sheets, stock #5360. + You're now ready to print labels, but you'll need to insert LaTeX code, + placing the commands \begin_inset Flex CharStyle:Code status collapsed @@ -1741,18 +1522,13 @@ If you're a typical American (we're still joking!), though, you don't care \begin_layout LyX-Code \backslash - -usepackage -{ -indentfirst -} +usepackage{indentfirst} \end_layout \begin_layout Standard -If your TeX distribution isn't -braindead -, you'll have this package, and all of your paragraphs will get the indentation - the Founding Fathers intended they should have. +If your TeX distribution isn't braindead, you'll have this package, and + all of your paragraphs will get the indentation the Founding Fathers intended + they should have. \end_layout \begin_layout Subsubsection @@ -1762,9 +1538,7 @@ Example #4: This Document \begin_layout Standard You can also check out the preamble of this document to get an idea of some of the advanced things you can do. - Also, there are more examples and an assortment of -LaTeX - + Also, there are more examples and an assortment of LaTeX \begin_inset Quotes eld \end_inset @@ -1788,27 +1562,14 @@ reference "cha:secrets" \end_layout \begin_layout Section -LyX and -LaTeX - Errors +LyX and LaTeX Errors \end_layout \begin_layout Standard -When LyX calls -LaTeX -, it tells -LaTeX - to blithely ignore any errors and keep going. - It then uses the -logfile - from the -LaTeX - run to do a post- -mortem -. - After analyzing the -logfile -,LyX displays a dialog listing the errors. +When LyX calls LaTeX, it tells LaTeX to blithely ignore any errors and keep + going. + It then uses the logfile from the LaTeX run to do a post-mortem. + After analyzing the logfile,LyX displays a dialog listing the errors. Clicking on any one of them will take you to the position in your LyX file where the error occurred. \begin_inset Foot @@ -1816,12 +1577,10 @@ status collapsed \begin_layout Plain Layout Well, usually. - Analyzing the -logfile - is a tough job, and LyX doesn't always go to the right line. - There are also cases where -LaTeX - reports the error on one line, but the actual error is earlier. + Analyzing the logfile is a tough job, and LyX doesn't always go to the + right line. + There are also cases where LaTeX reports the error on one line, but the + actual error is earlier. This is not unlike forgetting a closing brace in a program: You'll get an error, but only later. \end_layout @@ -1855,9 +1614,7 @@ Log . There are some fairly common error messages and warnings. We'll cover those here. - You should look at a good -LaTeX - book for a complete listing. + You should look at a good LaTeX book for a complete listing. \end_layout \begin_layout Itemize @@ -1865,9 +1622,7 @@ LaTeX status collapsed \begin_layout Plain Layout - -LaTeX - Warning +LaTeX Warning \end_layout \end_inset @@ -1885,13 +1640,10 @@ debugging \begin_inset Quotes erd \end_inset - the -LaTeX - code itself. + the LaTeX code itself. You'll get messages like this if you added or changed cross-references - or bibliography entries, in which case, -LaTeX - is trying to tell you that you need to make another run. + or bibliography entries, in which case, LaTeX is trying to tell you that + you need to make another run. You can by-and-large ignore these. \end_layout @@ -1900,9 +1652,7 @@ LaTeX status collapsed \begin_layout Plain Layout - -LaTeX - Font Warning +LaTeX Font Warning \end_layout \end_inset @@ -1911,13 +1661,9 @@ LaTeX \begin_inset Newline newline \end_inset -Another warning message, this time about fonts which -LaTeX - couldn't find. +Another warning message, this time about fonts which LaTeX couldn't find. The rest of the message will often say something about a replacement font - that -LaTeX - used. + that LaTeX used. You can safely ignore these, too. \end_layout @@ -1928,7 +1674,6 @@ status collapsed \begin_layout Plain Layout Overfull \backslash - hbox \end_layout @@ -1938,9 +1683,7 @@ hbox \begin_inset Newline newline \end_inset - -LaTeX - absolutely +LaTeX absolutely \emph on loves \emph default @@ -1950,10 +1693,8 @@ loves Almost always, this is unnoticeable in the final output. (It can be just a point or two.) Or, only one or two characters extend past the margin. - -LaTeX - seems to generate at least one of these messages for just about any document - you write. + LaTeX seems to generate at least one of these messages for just about any + document you write. \begin_inset Newline newline \end_inset @@ -1964,9 +1705,7 @@ You can ignore these messages. status collapsed \begin_layout Plain Layout -You can also enable the ` -draft' - option in +You can also enable the `draft' option in \begin_inset Flex CharStyle:MenuItem status collapsed @@ -1981,9 +1720,7 @@ Settings \end_inset -, and then -LaTeX - will draw a black box in the margin of lines that are overfull. +, and then LaTeX will draw a black box in the margin of lines that are overfull. \end_layout \end_inset @@ -1996,11 +1733,8 @@ LaTeX status collapsed \begin_layout Plain Layout - -Underfull - +Underfull \backslash - hbox \end_layout @@ -2011,10 +1745,8 @@ hbox \end_inset Not quite as common as its cousin. - -LaTeX - seems to like to print lines that are a bit too wide as opposed to ones - that are a bit too narrow. + LaTeX seems to like to print lines that are a bit too wide as opposed to + ones that are a bit too narrow. We have no idea why. \end_layout @@ -2025,7 +1757,6 @@ status collapsed \begin_layout Plain Layout Overfull \backslash - vbox \end_layout @@ -2036,11 +1767,8 @@ vbox status collapsed \begin_layout Plain Layout - -Underfull - +Underfull \backslash - vbox \end_layout @@ -2060,15 +1788,11 @@ Warnings about troubles breaking the page. status collapsed \begin_layout Plain Layout - -LaTeX - Error: File + LaTeX Error: File \begin_inset Quotes els \end_inset - Xxxx - \begin_inset Quotes ers \end_inset @@ -2085,9 +1809,7 @@ The file \begin_inset Quotes eld \end_inset - Xxxx - \begin_inset Quotes erd \end_inset @@ -2100,9 +1822,7 @@ status collapsed \begin_layout Plain Layout \backslash - -usepackage -{} +usepackage{} \end_layout \end_inset @@ -2114,9 +1834,7 @@ status collapsed \begin_layout Plain Layout Help\SpecialChar \menuseparator - -LaTeX - Configuration +LaTeX Configuration \end_layout \end_inset @@ -2144,9 +1862,7 @@ status collapsed \begin_layout Plain Layout \backslash - -usepackage -{} +usepackage{} \end_layout \end_inset @@ -2160,9 +1876,7 @@ usepackage status collapsed \begin_layout Plain Layout - -LaTeX - Error: Unknown option +LaTeX Error: Unknown option \end_layout \end_inset @@ -2190,9 +1904,8 @@ Undefined control sequence \begin_inset Newline newline \end_inset -If you've inserted -LaTeX - code into your document, but made a typo, you'll get one of these. +If you've inserted LaTeX code into your document, but made a typo, you'll + get one of these. You may have forgotten to load a package. In any case, this error message usually means that you used an undefined command. @@ -2202,9 +1915,7 @@ LaTeX \begin_layout Standard There are other error and warning messages. Some are self-explanatory. - These are usually -LaTeX - messages. + These are usually LaTeX messages. Others are downright cryptic. These are usually TeX error messages, and we really have \emph on @@ -2219,9 +1930,7 @@ There's a general sequence you should follow if you get error messages: \end_layout \begin_layout Enumerate -Look at the -LaTeX - code you inserted for typos. +Look at the LaTeX code you inserted for typos. \end_layout \begin_layout Enumerate @@ -2255,11 +1964,8 @@ begin{document} \end_layout \begin_layout Enumerate -If you didn't add anything to the preamble and didn't add any -LaTeX - code to the document, the first suspect is your -LaTeX - distribution itself. +If you didn't add anything to the preamble and didn't add any LaTeX code + to the document, the first suspect is your LaTeX distribution itself. Check for missing packages and install them. \end_layout @@ -2289,7 +1995,6 @@ Blanks status collapsed \begin_layout Plain Layout - Linebreaks \end_layout @@ -2300,7 +2005,6 @@ Linebreaks status collapsed \begin_layout Plain Layout - Pagebreaks \end_layout @@ -2318,12 +2022,9 @@ All right, you didn't use any of the fine-tuning options, you played by \end_layout \begin_layout Enumerate -Do you have long sections of text where -LaTeX - cannot find a place to break a line? By default, -LaTeX - is rather strict about how much extra inter-word spacing it will add in - order to break a line. +Do you have long sections of text where LaTeX cannot find a place to break + a line? By default, LaTeX is rather strict about how much extra inter-word + spacing it will add in order to break a line. Preferably, you should rework the paragraph to avoid the problem. If this isn't an option, you can wrap your text in \begin_inset Flex CharStyle:Code @@ -2332,15 +2033,12 @@ status collapsed \begin_layout Plain Layout \backslash - sloppypar \end_layout \end_inset - to make -LaTeX's - line breaking more, well, sloppy. + to make LaTeX's line breaking more, well, sloppy. \end_layout \begin_layout Enumerate @@ -2351,9 +2049,7 @@ Did you go overboard with the nesting? LyX (currently) doesn't check to \end_inset level, that's the problem. - (The limit in -LaTeX - is five.) + (The limit in LaTeX is five.) \end_layout \begin_layout Enumerate @@ -2391,18 +2087,13 @@ Supplemental Tools \end_layout \begin_layout Section -Customizing Bibliographies with -BibTeX +Customizing Bibliographies with BibTeX \end_layout \begin_layout Standard -The basics how to use -BibTeX - are explained in section +The basics how to use BibTeX are explained in section \emph on -Bibliography databases ( -BibTeX -) +Bibliography databases (BibTeX) \emph default of the \emph on @@ -2418,9 +2109,7 @@ Alternative Citation Styles \end_layout \begin_layout Standard -Standard -BibTeX - uses numbers (e. +Standard BibTeX uses numbers (e. \begin_inset space \thinspace{} \end_inset @@ -2432,9 +2121,7 @@ g. \begin_inset Quotes eld \end_inset -[ -12 -] +[12] \begin_inset Quotes erd \end_inset @@ -2452,9 +2139,7 @@ g. \begin_inset Quotes eld \end_inset -Knuth -1984a - +Knuth 1984a \begin_inset Quotes erd \end_inset @@ -2464,7 +2149,6 @@ Knuth status collapsed \begin_layout Plain Layout - natbib \end_layout @@ -2475,7 +2159,6 @@ natbib status collapsed \begin_layout Plain Layout - jurabib \end_layout @@ -2489,7 +2172,6 @@ jurabib status collapsed \begin_layout Plain Layout - natbib \end_layout @@ -2500,7 +2182,6 @@ natbib status collapsed \begin_layout Plain Layout - natbib \end_layout @@ -2513,7 +2194,6 @@ natbib status collapsed \begin_layout Plain Layout - jurabib \end_layout @@ -2550,7 +2230,6 @@ Bibliography status collapsed \begin_layout Plain Layout - Natbib \end_layout @@ -2561,7 +2240,6 @@ Natbib status collapsed \begin_layout Plain Layout - Jurabib \end_layout @@ -2573,9 +2251,7 @@ Jurabib \begin_inset Quotes eld \end_inset -Knuth -1984 - +Knuth 1984 \begin_inset Quotes erd \end_inset @@ -2583,9 +2259,7 @@ Knuth \begin_inset Quotes eld \end_inset -Knuth ( -1984 -) +Knuth (1984) \begin_inset Quotes erd \end_inset @@ -2593,9 +2267,7 @@ Knuth ( \begin_inset Quotes eld \end_inset -Knuth, -1984 - +Knuth, 1984 \begin_inset Quotes erd \end_inset @@ -2603,9 +2275,7 @@ Knuth, \begin_inset Quotes eld \end_inset - 1984 - \begin_inset Quotes erd \end_inset @@ -2638,7 +2308,6 @@ ftp://ctan.tug.org/tex-archive/macros/latex/contrib/custom-bib/ status collapsed \begin_layout Plain Layout - natbib \end_layout @@ -2663,14 +2332,9 @@ must have \end_inset . - Unfortunately, -BibTeX - itself does not allow you to do this. - But with the help of some -LaTeX - packages, -BibTeX - can be extended to fit your needs. + Unfortunately, BibTeX itself does not allow you to do this. + But with the help of some LaTeX packages, BibTeX can be extended to fit + your needs. \end_layout \begin_layout Standard @@ -2788,12 +2452,9 @@ Sectioned bibliography \end_inset . - Now you can insert multiple -BibTeX - bibliographies, one for each section of your bibliography. - Returning to our example: Insert the -BibTeX - bibliography + Now you can insert multiple BibTeX bibliographies, one for each section + of your bibliography. + Returning to our example: Insert the BibTeX bibliography \begin_inset Flex CharStyle:Code status collapsed @@ -2828,9 +2489,7 @@ all cited references \begin_inset Quotes eld \end_inset -all -uncited - references +all uncited references \begin_inset Quotes erd \end_inset @@ -2856,9 +2515,7 @@ Cited sources \begin_inset Quotes eld \end_inset - -Uncited - sources +Uncited sources \begin_inset Quotes erd \end_inset @@ -2877,7 +2534,6 @@ Scientific works status collapsed \begin_layout Plain Layout - bibtopic \end_layout @@ -2901,15 +2557,12 @@ g. \end_inset a bibliography for each section or chapter of the document, are not supported - by -BibTeX - itself. + by BibTeX itself. But the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - bibtopic \end_layout @@ -2948,7 +2601,6 @@ An alternative approach is to use the status collapsed \begin_layout Plain Layout - chapterbib \end_layout @@ -2959,7 +2611,6 @@ chapterbib status collapsed \begin_layout Plain Layout - bibunits \end_layout @@ -3007,18 +2658,15 @@ Sectioned bibliography . In the document, you have to enclose the sections, which shall contain - their own bibliography (including the -BibTeX - bibliography itself), between + their own bibliography (including the BibTeX bibliography itself), between + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout \backslash -begin{ -btUnit -} +begin{btUnit} \end_layout \end_inset @@ -3030,9 +2678,7 @@ status collapsed \begin_layout Plain Layout \backslash -end{ -btUnit -} +end{btUnit} \end_layout \end_inset @@ -3044,7 +2690,6 @@ btUnit status collapsed \begin_layout Plain Layout - btUnit \end_layout @@ -3061,7 +2706,6 @@ Note: status collapsed \begin_layout Plain Layout - btUnit \end_layout @@ -3073,7 +2717,6 @@ btUnit status collapsed \begin_layout Plain Layout - btUnit \end_layout @@ -3083,9 +2726,7 @@ s cannot be nested. \end_layout \begin_layout Section - -Multipart - Documents +Multipart Documents \end_layout \begin_layout Subsection @@ -3097,9 +2738,7 @@ When you are working on a large file with many sections, it is often convenient to break up the document into several files, or perhaps you have something where a table may change from time to time, but the preceding text does not. - In these cases, you should seriously consider using -multipart - documents. + In these cases, you should seriously consider using multipart documents. For example, scientific papers often have five major sections: the introduction , observations, results, discussion, and conclusion. Each of these could be its own separate LyX file, with one @@ -3117,9 +2756,8 @@ master file. Each of these files must have the same document class, however—don't attempt to mix book classes with article classes. - You may also include -LaTeX - files; however, these files must not have their own preamble (i. + You may also include LaTeX files; however, these files must not have their + own preamble (i. \begin_inset space \thinspace{} \end_inset @@ -3152,9 +2790,7 @@ end{document} \end_inset line must be deleted) or else errors will be generated when you try to - make a -DVI - file. + make a DVI file. \end_layout \begin_layout Standard @@ -3164,9 +2800,7 @@ status collapsed \begin_layout Plain Layout Insert\SpecialChar \menuseparator - ChiId - \begin_inset space ~ \end_inset @@ -3226,9 +2860,8 @@ input \begin_inset Quotes erd \end_inset - is really only meaningful to -LaTeXperts -, but the practical difference is that files which are + is really only meaningful to LaTeXperts, but the practical difference is + that files which are \begin_inset Quotes eld \end_inset @@ -3248,11 +2881,9 @@ inputted \end_layout \begin_layout Standard -Generally, the master file is converted into a full -LaTeX - file before typesetting, while the included files are converted to -LaTeX - files which do not have all the preamble information. +Generally, the master file is converted into a full LaTeX file before typesettin +g, while the included files are converted to LaTeX files which do not have + all the preamble information. \end_layout \begin_layout Standard @@ -3308,9 +2939,7 @@ output \end_inset - -checkbox - typesets a mark to unambiguously define the presence of a space. + checkbox typesets a mark to unambiguously define the presence of a space. \end_layout @@ -3335,9 +2964,7 @@ status open This section is somewhat out of date. Need to describe default master documents and how children are opened when the master is. - [[ -FIXME -]] + [[FIXME]] \end_layout \end_inset @@ -3363,8 +2990,7 @@ buffer \end_layout \begin_layout Subsection -Bibliography Lists in all -Subdocuments +Bibliography Lists in all Subdocuments \end_layout \begin_layout Standard @@ -3382,9 +3008,7 @@ status open \begin_layout Plain Layout This section also needs updating. - There is now material about this on the -wiki -, and it could be copied here. + There is now material about this on the wiki, and it could be copied here. \end_layout \end_inset @@ -3393,9 +3017,8 @@ wiki \end_layout \begin_layout Standard -Copy the bibliography list with all entries to all -subdocuments - and transform them to a comment. +Copy the bibliography list with all entries to all subdocuments and transform + them to a comment. This way LyX will find the \begin_inset Flex CharStyle:Code status collapsed @@ -3411,13 +3034,9 @@ status collapsed \end_layout \begin_layout Standard -As the bibliography list is in a comment, -LaTeX - won't use use it and the references will look like this: [?], instead of - like this: [1]. - One solution is to use the -LaTeX --package +As the bibliography list is in a comment, LaTeX won't use use it and the + references will look like this: [?], instead of like this: [1]. + One solution is to use the LaTeX-package \begin_inset Flex CharStyle:Code status collapsed @@ -3428,27 +3047,19 @@ comment \end_inset that will only include comments by processing the files separately. - To do this, add in the -LaTeX - preamble of every -subdocument - the following: + To do this, add in the LaTeX preamble of every subdocument the following: \end_layout \begin_layout LyX-Code \backslash - -usepackage -{comment} +usepackage{comment} \end_layout \begin_layout LyX-Code \backslash - -includecomment -{comment} +includecomment{comment} \end_layout \begin_layout Standard @@ -3483,9 +3094,8 @@ article document class, all you get is a centered page number at the bottom of the page. - This document uses -KOMA --script's book class, so it appears to be a bit fancier. + This document uses KOMA-script's book class, so it appears to be a bit + fancier. But to really put on a show, you need to set the document page style to \begin_inset Quotes eld @@ -3500,10 +3110,7 @@ fancy User Guide \emph default . - This section describes the -LaTeX - code you need to insert in your -LaTeX + This section describes the LaTeX code you need to insert in your LaTeX preamble in order to get the desired effects. \end_layout @@ -3513,7 +3120,6 @@ For more information on fancy headers, see the status collapsed \begin_layout Plain Layout - fancyhdr \end_layout @@ -3525,17 +3131,12 @@ fancyhdr status collapsed \begin_layout Plain Layout - -fancyhdr -. -dvi +fancyhdr.dvi \end_layout \end_inset -, which should have been installed with your -LaTeX - distribution, or +, which should have been installed with your LaTeX distribution, or \begin_inset CommandInset href LatexCommand href name "online" @@ -3573,16 +3174,13 @@ right . The footer is also divided into these three fields. - The -LaTeX - commands to set these fields in the simplest manner are + The LaTeX commands to set these fields in the simplest manner are \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout \backslash - lhead \end_layout @@ -3595,7 +3193,6 @@ status collapsed \begin_layout Plain Layout \backslash - chead \end_layout @@ -3608,7 +3205,6 @@ status collapsed \begin_layout Plain Layout \backslash - rhead \end_layout @@ -3621,7 +3217,6 @@ status collapsed \begin_layout Plain Layout \backslash - lfoot \end_layout @@ -3638,12 +3233,8 @@ lfoot \family typewriter \backslash - -lhead -{John Q. - -DocWriter -} +lhead{John Q. + DocWriter} \end_layout \begin_layout Standard @@ -3662,9 +3253,7 @@ g.: \family typewriter \backslash - -cfoot -{} +cfoot{} \end_layout \begin_layout Standard @@ -3702,13 +3291,9 @@ Page 4) in the upper right, your name in the lower left, and the date in \family typewriter \backslash - -lhead -{Section +lhead{Section \backslash - -thesection -} +thesection} \end_layout \begin_layout Standard @@ -3716,9 +3301,7 @@ thesection \family typewriter \backslash - -chead -{} +chead{} \end_layout \begin_layout Standard @@ -3726,13 +3309,9 @@ chead \family typewriter \backslash - -rhead -{Page +rhead{Page \backslash - -thepage -} +thepage} \end_layout \begin_layout Standard @@ -3740,12 +3319,8 @@ thepage \family typewriter \backslash - -lfoot -{John Q. - -DocWriter -} +lfoot{John Q. + DocWriter} \end_layout \begin_layout Standard @@ -3753,9 +3328,7 @@ DocWriter \family typewriter \backslash - -cfoot -{} +cfoot{} \end_layout \begin_layout Standard @@ -3763,9 +3336,7 @@ cfoot \family typewriter \backslash - -rfoot -{ +rfoot{ \backslash today} \end_layout @@ -3778,7 +3349,6 @@ status collapsed \begin_layout Plain Layout \backslash - thesection \end_layout @@ -3791,16 +3361,13 @@ status collapsed \begin_layout Plain Layout \backslash - thepage \end_layout \end_inset - access -LaTeX's - section and page counters, and so print out the current section and page - numbers. + access LaTeX's section and page counters, and so print out the current + section and page numbers. \begin_inset Flex CharStyle:Code status collapsed @@ -3820,11 +3387,7 @@ today The thicknesses of the horizontal rules drawn beneath the header and above the footer can also be modified. If you don't want one of the rules, set its thickness to 0. - The header rule has a default thickness of 0. -4pt -, the footer rule is -0pt -. + The header rule has a default thickness of 0.4pt, the footer rule is 0pt. Use commands \family typewriter @@ -3836,15 +3399,9 @@ status collapsed \begin_layout Plain Layout \backslash - -renewcommand -{ +renewcommand{ \backslash - -headrulewidth -}{0. -4pt -} +headrulewidth}{0.4pt} \end_layout \end_inset @@ -3856,15 +3413,9 @@ status collapsed \begin_layout Plain Layout \backslash - -renewcommand -{ +renewcommand{ \backslash - -footrulewidth -}{0. -4pt -} +footrulewidth}{0.4pt} \end_layout \end_inset @@ -3881,9 +3432,7 @@ status collapsed \begin_layout Plain Layout \backslash - -thispagestyle -{empty} +thispagestyle{empty} \end_layout \end_inset @@ -3895,9 +3444,7 @@ status collapsed \begin_layout Plain Layout \backslash - -thispagestyle -{plain} +thispagestyle{plain} \end_layout \end_inset @@ -3909,9 +3456,7 @@ status collapsed \begin_layout Plain Layout \backslash - -thispagestyle -{fancy} +thispagestyle{fancy} \end_layout \end_inset @@ -3926,9 +3471,7 @@ thispagestyle \begin_layout Standard As a final example, it is possible to include an image in the header or footer. - Suppose you want to put a company logo in the upper -lefthand - corner. + Suppose you want to put a company logo in the upper lefthand corner. You might try something like \end_layout @@ -3937,21 +3480,11 @@ lefthand \family typewriter \backslash - -lhead -{ +lhead{ \backslash - -resizebox -{ -1in -}{!}{ +resizebox{1in}{!}{ \backslash - -includegraphics -{logo. -eps -}}} +includegraphics{logo.eps}}} \end_layout \begin_layout Standard @@ -3964,9 +3497,7 @@ status collapsed \noindent \backslash - -usepackage -{graphics} +usepackage{graphics} \end_layout \end_inset @@ -3996,9 +3527,7 @@ Introduction \end_layout \begin_layout Standard -LyX provides -216 - bullet shapes that can be accessed from a simple dialog. +LyX provides 216 bullet shapes that can be accessed from a simple dialog. Using this dialog you can easily specify what bullet shape to use at each level of an itemized list. These settings are document-wide so you won't be able to specify different @@ -4051,20 +3580,14 @@ The dialog provides you with a table of bullet shapes. The row of buttons across the top is used to select which bullet depth you are changing. A text entry under the table shows the currently selected bullet shape's - -LaTeX - equivalent and this can be edited if desired. + LaTeX equivalent and this can be edited if desired. If you do modify the text you will also need to specify any needed packages - in the -LaTeX - preamble. + in the LaTeX preamble. \end_layout \begin_layout Standard The six panels are divided up by the packages they require. - The following table shows the mappings from button name to -LaTeX - packages. + The following table shows the mappings from button name to LaTeX packages. \end_layout \begin_layout Standard @@ -4143,8 +3666,7 @@ Standard \bar no \noun off \color none -base -LaTeX +base LaTeX \end_layout \end_inset @@ -4182,8 +3704,7 @@ Maths \bar no \noun off \color none -amssymb -.sty +amssymb.sty \end_layout \end_inset @@ -4221,8 +3742,7 @@ Ding1 \bar no \noun off \color none -pifont -.sty +pifont.sty \end_layout \end_inset @@ -4260,8 +3780,7 @@ Ding2 \bar no \noun off \color none -pifont -.sty +pifont.sty \end_layout \end_inset @@ -4299,8 +3818,7 @@ Ding3 \bar no \noun off \color none -pifont -.sty +pifont.sty \end_layout \end_inset @@ -4338,8 +3856,7 @@ Ding4 \bar no \noun off \color none -pifont -.sty +pifont.sty \end_layout \end_inset @@ -4354,10 +3871,8 @@ pifont \begin_layout Standard LyX doesn't stop you using bullets from packages you don't have. - If you get errors from -LaTeX - when you try to view or print the file, then it is likely you are missing - a package. + If you get errors from LaTeX when you try to view or print the file, then + it is likely you are missing a package. \begin_inset Foot status collapsed @@ -4396,9 +3911,7 @@ really want to have multiple sets of paragraphs with different sets of bullets in each, then you're going to have to get your hands dirty with TeX code. The bullet selection dialog can help though because it provides you with - the -LaTeX - code for a wide range of bullet shapes. + the LaTeX code for a wide range of bullet shapes. To make your own custom paragraphs you have the following options: \end_layout @@ -4449,30 +3962,23 @@ sharp \end_layout \begin_layout Itemize -Use the -LaTeX - command +Use the LaTeX command \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout \backslash - -renewcommand -{}{} +renewcommand{}{} \end_layout \end_inset to specify a new bullet shape for a given depth. You'll also need to save the current bullet shape so you can restore it - again -afterwards -. - In this itemized list the following -LaTeX - code was used to change the bullet used for the first depth. + again afterwards. + In this itemized list the following LaTeX code was used to change the bullet + used for the first depth. \end_layout \begin_deeper @@ -4481,25 +3987,17 @@ LaTeX \backslash let \backslash - -savelabelitemi -= +savelabelitemi= \backslash - -labelitemi - +labelitemi \end_layout \begin_layout LyX-Code \backslash - renewcommand - \backslash - -labelitemi -[0]{ +labelitemi[0]{ \backslash small \backslash @@ -4517,7 +4015,6 @@ Note that the itemize depth is specified in Roman numerals as part of the \family typewriter \backslash - labelitem \family default command. @@ -4592,27 +4089,19 @@ savelabelitemi} \end_layout \begin_layout Plain Layout -You'll also need to revert the -labelitem - back to its previous setting for the global bullet shape settings to remain - in effect. +You'll also need to revert the labelitem back to its previous setting for + the global bullet shape settings to remain in effect. The way used here was: \end_layout \begin_layout LyX-Code \backslash - renewcommand - \backslash - -labelitemi -[0]{ +labelitemi[0]{ \backslash - -savelabelitemi -} +savelabelitemi} \end_layout \end_inset @@ -4629,15 +4118,11 @@ Introduction \end_layout \begin_layout Standard -The `LyX -server' - allows other programs to talk to LyX, invoke LyX commands, and retrieve - information about the LyX internal state. +The `LyX server' allows other programs to talk to LyX, invoke LyX commands, + and retrieve information about the LyX internal state. This is only intended for advanced users, but they should find it useful. It is by writing to the LyX server, for example, that bibliography managers, - such as -JabRef -, are able to + such as JabRef, are able to \begin_inset Quotes eld \end_inset @@ -4651,9 +4136,7 @@ push \begin_layout Standard Please note that, at present, \emph on -the server does not work -natively - on Windows +the server does not work natively on Windows \emph default \begin_inset Foot @@ -4667,9 +4150,7 @@ There is no reason it cannot do so. \end_inset - but it does work with -Cygwin - versions of LyX. + but it does work with Cygwin versions of LyX. \end_layout \begin_layout Section @@ -4683,7 +4164,6 @@ The LyX server works through the use of a pair of named pipes. status collapsed \begin_layout Plain Layout - UserDir \end_layout @@ -4698,9 +4178,7 @@ UserDir status collapsed \begin_layout Plain Layout - -lyxpipe -.in +lyxpipe.in \end_layout \end_inset @@ -4718,9 +4196,7 @@ lyxpipe status collapsed \begin_layout Plain Layout - -lyxpipe -.out +lyxpipe.out \end_layout \end_inset @@ -4735,9 +4211,7 @@ lyxpipe status collapsed \begin_layout Plain Layout -. -lyxpipe -.in +.lyxpipe.in \end_layout \end_inset @@ -4747,9 +4221,7 @@ lyxpipe status collapsed \begin_layout Plain Layout -. -lyxpipe -.out +.lyxpipe.out \end_layout \end_inset @@ -4771,11 +4243,7 @@ Preferences status collapsed \begin_layout Plain Layout -"/home/ -myhome -/ -lyxpipe -" +"/home/myhome/lyxpipe" \end_layout \end_inset @@ -4850,12 +4318,7 @@ If you are developing a client program, you might find it useful to enable status collapsed \begin_layout Plain Layout - -lyx - - -dbg - -lyxserver +lyx -dbg lyxserver \end_layout \end_inset @@ -4870,9 +4333,7 @@ You can find a complete example client written in C in the source distribution status collapsed \begin_layout Plain Layout -development/ -lyxserver -/server_monitor.c +development/lyxserver/server_monitor.c \end_layout \end_inset @@ -4886,10 +4347,7 @@ Another useful tool is command-line based client you will find in status collapsed \begin_layout Plain Layout - -src -/client/ -lyxclient +src/client/lyxclient \end_layout \end_inset @@ -4908,9 +4366,7 @@ To issue a LyX call, the client writes a line of ASCII text into the input \end_layout \begin_layout Quote - -LYXCMD -: +LYXCMD: \emph on clientname \emph default @@ -4924,20 +4380,14 @@ argument \end_layout \begin_layout Description - -clientname - is a name that the client can choose arbitrarily. +clientname is a name that the client can choose arbitrarily. Its only use is that LyX will echo it if it sends an answer—so a client - can dispatch results from different -requesters -. + can dispatch results from different requesters. \end_layout \begin_layout Description function is the function you want LyX to perform. - It is the same as the commands you'd use in the -minibuffer -. + It is the same as the commands you'd use in the minibuffer. \end_layout \begin_layout Description @@ -4950,9 +4400,7 @@ self-insert \begin_inset Quotes erd \end_inset - -LFUN - will insert the argument as text at the cursor position). + LFUN will insert the argument as text at the cursor position). \end_layout \begin_layout Standard @@ -5032,27 +4480,15 @@ Examples: \end_layout \begin_layout LyX-Code -echo " -LYXCMD -:test:beginning-of-buffer:" >~/. -lyxpipe -.in +echo "LYXCMD:test:beginning-of-buffer:" >~/.lyxpipe.in \begin_inset Newline newline \end_inset -echo " -LYXCMD -:test:get- -xy -:" >~/. -lyxpipe -.in +echo "LYXCMD:test:get-xy:" >~/.lyxpipe.in \begin_inset Newline newline \end_inset -read a <~/. -lyxpipe -.out +read a <~/.lyxpipe.out \begin_inset Newline newline \end_inset @@ -5128,9 +4564,7 @@ LyX implements a simple protocol that can be used for session management. \end_layout \begin_layout Quote - -LYXSRV -: +LYXSRV: \emph on clientname \emph default @@ -5182,34 +4616,17 @@ bye \end_layout \begin_layout Section -Reverse -DVI -/ -PDF - search +Reverse DVI/PDF search \end_layout \begin_layout Standard -Some -DVI -/ -PDF - viewers +Some DVI/PDF viewers \begin_inset Foot status collapsed \begin_layout Plain Layout -The following viewers offer the reverse -PDF - search feature: -Okular - on -KDE -/Linux, Skim on Mac -OSX - and -SumatraPDF - on Windows. +The following viewers offer the reverse PDF search feature: Okular on KDE/Linux, + Skim on Mac OSX and SumatraPDF on Windows. \end_layout \end_inset @@ -5224,11 +4641,7 @@ inverse search \emph default ). This means that you can tell LyX to put the cursor to a specific line in - the document by clicking at the respective position in the -DVI -/ -PDF - output. + the document by clicking at the respective position in the DVI/PDF output. To achieve this, the viewer must be able to communicate with LyX. This is done via the LyX server either by using the named pipe ( \emph on @@ -5243,7 +4656,6 @@ lyxsocket status collapsed \begin_layout Plain Layout - lyxclient \end_layout @@ -5258,11 +4670,7 @@ lyxclient In what follows, we will thus describe how to setup reverse search for specific viewers. Before we turn to this, though, we will explain what needs to be done generally - to enable reverse search in the -DVI -/ -PDF - output. + to enable reverse search in the DVI/PDF output. \end_layout \begin_layout Subsection @@ -5270,55 +4678,39 @@ Enabling reverse search \end_layout \begin_layout Standard - -LaTeX - provides several different methods for reverse search. +LaTeX provides several different methods for reverse search. Some are built-in in the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -latex/ -pdflatex +latex/pdflatex \end_layout \end_inset program, some are provided by external packages. - Your choice depends on whether your -LaTeX - distribution already provides a given method (the built-in methods are - rather new) and whether your viewer can cope with it. + Your choice depends on whether your LaTeX distribution already provides + a given method (the built-in methods are rather new) and whether your viewer + can cope with it. The available methods are described in the following. \end_layout \begin_layout Subsubsection* -Built-in -DVI --search via - src --specials ( -DVI - only) +Built-in DVI-search via src-specials (DVI only) \end_layout \begin_layout Standard -This method provides the -DVI - file with the necessary information for reverse search. - It is available in -LaTeX - since quite some time (any somewhat recent -LaTeX +This method provides the DVI file with the necessary information for reverse + search. + It is available in LaTeX since quite some time (any somewhat recent LaTeX distribution should include it), and it works reliably. To enable it, change the \begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout - LaT - \begin_inset ERT status collapsed @@ -5329,10 +4721,7 @@ status collapsed \end_inset - -eX - (plain)-> -DVI +eX (plain)->DVI \end_layout \end_inset @@ -5342,9 +4731,7 @@ DVI status collapsed \begin_layout Plain Layout - LaT - \begin_inset ERT status collapsed @@ -5355,10 +4742,7 @@ status collapsed \end_inset - -eX - (plain)-> -DraftDVI +eX (plain)->DraftDVI \end_layout \end_inset @@ -5380,9 +4764,7 @@ Converters status collapsed \begin_layout Plain Layout -latex - -src --specials $$i +latex -src-specials $$i \end_layout \end_inset @@ -5393,11 +4775,7 @@ src \end_layout \begin_layout Subsubsection* -External Packages ( -PDFSync - and - scrltx -) +External Packages (PDFSync and scrltx) \end_layout \begin_layout Standard @@ -5409,13 +4787,8 @@ pdfsync \emph on scrltx \emph default - provide reverse search facility for -PDF - output (via -pdflatex -) and -DVI - output, respectively. + provide reverse search facility for PDF output (via pdflatex) and DVI output, + respectively. In order to enable it, load the packages in the LyX preamble: \end_layout @@ -5426,18 +4799,12 @@ status collapsed \begin_layout Plain Layout \backslash - -usepackage -{ -pdfsync -} +usepackage{pdfsync} \end_layout \end_inset - for reverse -PDF - search, + for reverse PDF search, \end_layout \begin_layout Itemize @@ -5448,54 +4815,35 @@ status collapsed \begin_layout Plain Layout \backslash - -usepackage -[active]{ -srcltx -} +usepackage[active]{srcltx} \end_layout \end_inset - for reverse -DVI - search. + for reverse DVI search. \end_layout \begin_layout Standard -If you want to be able to perform both -DVI - and -PDF - reverse searches, you can also insert in the preamble the following lines +If you want to be able to perform both DVI and PDF reverse searches, you + can also insert in the preamble the following lines \end_layout \begin_layout LyX-Code \backslash - -usepackage -{ -ifpdf -} +usepackage{ifpdf} \begin_inset Newline newline \end_inset \backslash - ifpdf - \begin_inset Newline newline \end_inset \backslash - -usepackage -{ -pdfsync -} +usepackage{pdfsync} \begin_inset Newline newline \end_inset @@ -5507,47 +4855,27 @@ else \backslash - -usepackage -[active]{ -srcltx -} +usepackage[active]{srcltx} \begin_inset Newline newline \end_inset \backslash - fi \end_layout \begin_layout Standard -This way, you can preview the file as either -DVI - or -PDF - ( -pdflatex -) and the right package will be used. +This way, you can preview the file as either DVI or PDF (pdflatex) and the + right package will be used. \end_layout \begin_layout Standard -Note that -PDFSync - might affect the output layout of your document. - It is therefore advised to disable -PDFsync - for final documents. +Note that PDFSync might affect the output layout of your document. + It is therefore advised to disable PDFsync for final documents. \end_layout \begin_layout Subsubsection* -Built-in reverse search via - SyncTeX - ( -DVI - and - PDF -) +Built-in reverse search via SyncTeX (DVI and PDF) \end_layout \begin_layout Standard @@ -5556,61 +4884,35 @@ Recent versions of status collapsed \begin_layout Plain Layout -( -pdf -)latex +(pdf)latex \end_layout \end_inset - have built-in support for both -PDF - and -DVI - reverse search. + have built-in support for both PDF and DVI reverse search. This so-called \emph on SyncTeX \emph default - facility is basically the result of the integration of the -PDFSync - package to the -pdftex - program and its merge with the + facility is basically the result of the integration of the PDFSync package + to the pdftex program and its merge with the \emph on -scr --specials +scr-specials \emph default approach. - You need at least -TeXLive - -2008 - or a recent -MikTeX - distribution in order to use it. - Also note that only a few -PDF - viewers (Skim on the Mac, -SumatraPDF - on Windows) already provide -SyncTeX - support. + You need at least TeXLive 2008 or a recent MikTeX distribution in order + to use it. + Also note that only a few PDF viewers (Skim on the Mac, SumatraPDF on Windows) + already provide SyncTeX support. \end_layout \begin_layout Standard -To enable -SyncTeX - for -DVI - output, change the +To enable SyncTeX for DVI output, change the \begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout - LaT - \begin_inset ERT status collapsed @@ -5621,10 +4923,7 @@ status collapsed \end_inset - -eX - (plain) -> -DVI +eX (plain) -> DVI \end_layout \end_inset @@ -5634,9 +4933,7 @@ DVI status collapsed \begin_layout Plain Layout - LaT - \begin_inset ERT status collapsed @@ -5647,10 +4944,7 @@ status collapsed \end_inset - -eX - (plain) -> -DraftDVI +eX (plain) -> DraftDVI \end_layout \end_inset @@ -5672,23 +4966,17 @@ Converters status collapsed \begin_layout Plain Layout -latex - -synctex -=1 $$i +latex -synctex=1 $$i \end_layout \end_inset -, and for -PDF - output, change the +, and for PDF output, change the \begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout - LaT - \begin_inset ERT status collapsed @@ -5699,15 +4987,7 @@ status collapsed \end_inset - -eX - ( -pdflatex -) -> -PDF - ( -pdflatex -) +eX (pdflatex) -> PDF (pdflatex) \end_layout \end_inset @@ -5717,20 +4997,14 @@ pdflatex status collapsed \begin_layout Plain Layout - -pdflatex - - -synctex -=1 $$i +pdflatex -synctex=1 $$i \end_layout \end_inset . Check the documentation of your viewer whether the viewer needs to be configure -d for the use with -SyncTeX -. +d for the use with SyncTeX. \begin_inset Foot status collapsed @@ -5740,24 +5014,18 @@ The status collapsed \begin_layout Plain Layout -- -synctex -=1 +-synctex=1 \end_layout \end_inset - option enables -gzip - compression. + option enables gzip compression. If your viewer does not support it, you should instead use \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -- -synctex -=-1 +-synctex=-1 \end_layout \end_inset @@ -5775,9 +5043,7 @@ Configuring and using specific viewers \end_layout \begin_layout Subsubsection* - -Xdvi - (all platforms) +Xdvi (all platforms) \end_layout \begin_layout Standard @@ -5786,21 +5052,18 @@ If you use status collapsed \begin_layout Plain Layout - xdvi \end_layout \end_inset -, you don't need to do anything else for performing a reverse -DVI - search, as LyX already provides the necessary hooks for automatically using - the +, you don't need to do anything else for performing a reverse DVI search, + as LyX already provides the necessary hooks for automatically using the + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - lyxclient \end_layout @@ -5808,18 +5071,13 @@ lyxclient program. Just setup your document as described above (reverse search is triggered - by -Ctrl --click or Alt-click on Mac -OSX -, respectively). + by Ctrl-click or Alt-click on Mac OSX, respectively). \end_layout \begin_layout Standard However, if for whatever reason you want to use the named pipe instead of - the socket for communicating with LyX, simply change the -DVI - viewer in + the socket for communicating with LyX, simply change the DVI viewer in + \begin_inset Flex CharStyle:MenuItem status collapsed @@ -5836,19 +5094,12 @@ File formats status collapsed \begin_layout Plain Layout -On Mac -OSX - you have to use +On Mac OSX you have to use \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -DISPLAY=:0.0 -xdvi - -editor -'lyxeditor -.sh %f % -l' +DISPLAY=:0.0 xdvi -editor 'lyxeditor.sh %f %l' \end_layout \end_inset @@ -5863,12 +5114,7 @@ l' status collapsed \begin_layout Plain Layout - -xdvi - -editor -'lyxeditor -.sh %f % -l' +xdvi -editor 'lyxeditor.sh %f %l' \end_layout \end_inset @@ -5878,9 +5124,7 @@ l' status collapsed \begin_layout Plain Layout - -lyxeditor -.sh +lyxeditor.sh \end_layout \end_inset @@ -5894,33 +5138,19 @@ lyxeditor \begin_inset Newline newline \end_inset - -LYXPIPE -="/path/to/ -lyxpipe -" +LYXPIPE="/path/to/lyxpipe" \begin_inset Newline newline \end_inset -COMMAND=" -LYXCMD -: -revdvi -:server- -goto --file-row:$1 $2" +COMMAND="LYXCMD:revdvi:server-goto-file-row:$1 $2" \begin_inset Newline newline \end_inset -echo "$COMMAND" > "${ -LYXPIPE -}".in || exit +echo "$COMMAND" > "${LYXPIPE}".in || exit \begin_inset Newline newline \end_inset -read < "${ -LYXPIPE -}".out || exit +read < "${LYXPIPE}".out || exit \end_layout \begin_layout Standard @@ -5929,8 +5159,7 @@ where status collapsed \begin_layout Plain Layout -/path/to/ -lyxpipe +/path/to/lyxpipe \end_layout \end_inset @@ -5946,9 +5175,7 @@ status open \end_inset - -XServer - pipe path specified in +XServer pipe path specified in \begin_inset Flex CharStyle:MenuItem status collapsed @@ -5979,7 +5206,6 @@ development/tools status collapsed \begin_layout Plain Layout - lyxeditor \end_layout @@ -5998,11 +5224,7 @@ lyxpipe \end_layout \begin_layout Subsubsection* - -MacDviX - (Mac -OSX -) +MacDviX (Mac OSX) \end_layout \begin_layout Standard @@ -6011,11 +5233,7 @@ At the end of status collapsed \begin_layout Plain Layout -/Applications/ -MacDviX -_Folder/ -calleditor -.script +/Applications/MacDviX_Folder/calleditor.script \end_layout \end_inset @@ -6035,11 +5253,7 @@ status collapsed \end_inset -X.app/Contents/ -MacOS -/ -lyxeditor - "$2" $1 +X.app/Contents/MacOS/lyxeditor "$2" $1 \begin_inset Newline newline \end_inset @@ -6056,9 +5270,7 @@ Reverse search is triggered by Alt-click (OPTION-click). \end_layout \begin_layout Subsubsection* -Skim (Mac -OSX -) +Skim (Mac OSX) \end_layout \begin_layout Standard @@ -6080,11 +5292,7 @@ status collapsed Preferences\SpecialChar \menuseparator File Handling\SpecialChar \menuseparator File formats\SpecialChar \menuseparator - -PDF - ( -pdflatex -) +PDF (pdflatex) \end_layout \end_inset @@ -6120,11 +5328,7 @@ Reverse search is triggered by COMMAND-SHIFT-click \end_layout \begin_layout Subsubsection* - -Okular - ( -KDE -) +Okular (KDE) \end_layout \begin_layout Standard @@ -6134,9 +5338,7 @@ status collapsed \begin_layout Plain Layout Settings\SpecialChar \menuseparator -Configure -Okular -\SpecialChar \ldots{} +Configure Okular\SpecialChar \ldots{} \SpecialChar \menuseparator Editor \end_layout @@ -6156,9 +5358,7 @@ Custom Text Editor status collapsed \begin_layout Plain Layout - -lyxclient - -g %f %l +lyxclient -g %f %l \end_layout \end_inset @@ -6171,9 +5371,7 @@ Reverse search is triggered by SHIFT-click. \end_layout \begin_layout Subsubsection* -YAP ( -Cygwin -) +YAP (Cygwin) \end_layout \begin_layout Standard @@ -6192,9 +5390,7 @@ Options \begin_inset Quotes eld \end_inset -Inverse -DVI - Search +Inverse DVI Search \begin_inset Quotes erd \end_inset @@ -6240,9 +5436,7 @@ Name: status collapsed \begin_layout Plain Layout - -lyxeditor -.bat +lyxeditor.bat \end_layout \end_inset @@ -6253,9 +5447,7 @@ lyxeditor status collapsed \begin_layout Plain Layout - -lyxeditor -.bat +lyxeditor.bat \end_layout \end_inset @@ -6285,25 +5477,19 @@ status collapsed status collapsed \begin_layout Plain Layout - lyxclient \end_layout \end_inset program. - Since yap is a native Windows application, the -filename - it provides should be converted to -POSIX - style before being passed to + Since yap is a native Windows application, the filename it provides should + be converted to POSIX style before being passed to \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -lyxeditor -.sh +lyxeditor.sh \end_layout \end_inset @@ -6313,7 +5499,6 @@ lyxeditor status collapsed \begin_layout Plain Layout - lyxclient \end_layout @@ -6324,9 +5509,7 @@ lyxclient status collapsed \begin_layout Plain Layout - -lyxeditor -.bat +lyxeditor.bat \end_layout \end_inset @@ -6339,21 +5522,11 @@ lyxeditor \begin_inset Newline newline \end_inset -if "%1" == "-g" -goto - -lyxclient - +if "%1" == "-g" goto lyxclient \begin_inset Newline newline \end_inset -bash -c -'lyxeditor -.sh $( -cygpath - -a "%1") % -2' - +bash -c 'lyxeditor.sh $(cygpath -a "%1") %2' \begin_inset Newline newline \end_inset @@ -6361,18 +5534,11 @@ exit \begin_inset Newline newline \end_inset -: -lyxclient - +:lyxclient \begin_inset Newline newline \end_inset -bash -c -'lyxclient - %1 $( -cygpath - -a "%2") % -3' +bash -c 'lyxclient %1 $(cygpath -a "%2") %3' \end_layout \begin_layout Standard @@ -6381,9 +5547,7 @@ You have to make sure that both status collapsed \begin_layout Plain Layout - -lyxeditor -.sh +lyxeditor.sh \end_layout \end_inset @@ -6393,17 +5557,13 @@ lyxeditor status collapsed \begin_layout Plain Layout - -lyxclient -. -exe +lyxclient.exe \end_layout \end_inset - are in the command PATH, otherwise you have to use their full -posix - path in the above batch file. + are in the command PATH, otherwise you have to use their full posix path + in the above batch file. \end_layout \begin_layout Standard @@ -6411,29 +5571,17 @@ In yap, reverse search is triggered by double-click. \end_layout \begin_layout Subsubsection* - -SumatraPDF - ( -Cygwin -) +SumatraPDF (Cygwin) \end_layout \begin_layout Standard -In -SumatraPDF -, you can set the name of the program that communicates with LyX by simply - launching -SumatraPDF - as +In SumatraPDF, you can set the name of the program that communicates with + LyX by simply launching SumatraPDF as \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -SumatraPDF - -inverse-search " -lyxeditor -.bat -g %f %l" +SumatraPDF -inverse-search "lyxeditor.bat -g %f %l" \end_layout \end_inset @@ -6454,19 +5602,15 @@ status collapsed status collapsed \begin_layout Plain Layout -It has been reported that -SumatraPDF - is not able to remember the settings if it is installed in the Program - Files system folder. +It has been reported that SumatraPDF is not able to remember the settings + if it is installed in the Program Files system folder. This problem can be avoided by installing it somewhere else, for example in \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -/ -usr -/local/bin +/usr/local/bin \end_layout \end_inset @@ -6476,9 +5620,7 @@ usr \end_inset - (in this way you will be using the -lyxsocket -; omit the + (in this way you will be using the lyxsocket; omit the \begin_inset Flex CharStyle:Code status collapsed @@ -6488,33 +5630,23 @@ status collapsed \end_inset - option if you want to use the -lyxpipe - and be sure that the + option if you want to use the lyxpipe and be sure that the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -lyxeditor -.sh +lyxeditor.sh \end_layout \end_inset script is in your command PATH). - If -SumatraPDF - is not your default -PDF - viewer, you should enter + If SumatraPDF is not your default PDF viewer, you should enter \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -SumatraPDF -.sh +SumatraPDF.sh \end_layout \end_inset @@ -6527,11 +5659,7 @@ status collapsed Preferences\SpecialChar \menuseparator File Handling\SpecialChar \menuseparator File formats\SpecialChar \menuseparator - -PDF - ( -pdflatex -) +PDF (pdflatex) \end_layout \end_inset @@ -6541,9 +5669,7 @@ pdflatex status collapsed \begin_layout Plain Layout - -SumatraPDF -.sh +SumatraPDF.sh \end_layout \end_inset @@ -6553,9 +5679,7 @@ SumatraPDF status collapsed \begin_layout Plain Layout -/ -usr -/local/bin +/usr/local/bin \end_layout \end_inset @@ -6568,31 +5692,16 @@ usr \begin_inset Newline newline \end_inset - -cd - $( -dirname - $1) +cd $(dirname $1) \begin_inset Newline newline \end_inset - -SumatraPDF -. -exe - $( -basename - $1) +SumatraPDF.exe $(basename $1) \end_layout \begin_layout Standard -This is needed because -SumatraPDF - is a native Windows application and does not understand the -posix - paths used by the -Cygwin - version of LyX. +This is needed because SumatraPDF is a native Windows application and does + not understand the posix paths used by the Cygwin version of LyX. \end_layout \begin_layout Standard @@ -6610,8 +5719,7 @@ A&A Paper \begin_layout Standard by \noun on -Peter -Sütterlin +Peter Sütterlin \end_layout \begin_layout Subsection @@ -6624,13 +5732,7 @@ This section describes how LyX can be used to write articles for submission \emph on Astronomy and Astrophysics \emph default - ( -www -. -edpsciences -.fr/ -aa -/ + (www.edpsciences.fr/aa/ \begin_inset Flex URL status collapsed @@ -6641,13 +5743,9 @@ http://www.edpsciences.fr/aa/ \end_inset -) using Version 5. -01 - of the document class +) using Version 5.01 of the document class \family typewriter -aa -. -cls +aa.cls \family default . This package can be downloaded from the ftp site @@ -6691,30 +5789,19 @@ A manual comes together with that package, and this text is not meant to \begin_layout Standard Please note that the publisher of the journal was changed from Springer - to EDP Sciences starting January 1, -2001 -. + to EDP Sciences starting January 1, 2001. That change implicated also some slight changes of the style files, namely the removal of the thesaurus command. - The LyX class -aa - supports the newest version of these style files, V 5. -01 -. + The LyX class aa supports the newest version of these style files, V 5.01. If you have an older version installed, please upgrade. For compatibility, the old (version 4) layout has been kept as \family sans -article (A&A -V4 -) +article (A&A V4) \family default . Please refer to the comments in \family typewriter -LyXDir -/layouts/ -aapaper -.layout +LyXDir/layouts/aapaper.layout \family default . \end_layout @@ -6832,7 +5919,6 @@ There is no need to issue the \family typewriter \backslash - maketitle \family default command, this is done automatically by LyX when the header is finished. @@ -6857,9 +5943,7 @@ Insert\SpecialChar \menuseparator Footnote. \family default - LyX will -automagically - use the term + LyX will automagically use the term \family typewriter \backslash @@ -6869,9 +5953,8 @@ thanks{} \end_layout \begin_layout Standard -In addition to these topics, the macros use three additional -LaTeX - commands that have no counterpart in LyX: +In addition to these topics, the macros use three additional LaTeX commands + that have no counterpart in LyX: \end_layout \begin_layout Itemize @@ -6890,9 +5973,7 @@ y. \family typewriter \backslash -inst{< -nr ->} +inst{} \family default to mark corresponding author/institute pairs. The institutes are numbered sequentially as they appear in the @@ -6914,9 +5995,7 @@ email{address} \begin_layout Standard In all cases, the appropriate command has to be entered in LyX and marked - as -LaTeX - code. + as LaTeX code. See the examples. \end_layout @@ -6928,21 +6007,16 @@ The abstract \begin_layout Standard The abstract should immediately follow the header block. With version 5 the abstract environment was changed to a command, and there - is now a -resctriction - to only one paragraph. + is now a resctriction to only one paragraph. In addition, it should contain an entry with the keywords. - This is not yet implemented for LyX, therefore you have to enter the -LaTeX + This is not yet implemented for LyX, therefore you have to enter the LaTeX command \family typewriter \backslash keywords{} \family default - by hand and mark it as -LaTeX - code. + by hand and mark it as LaTeX code. Refer to the example paper. \end_layout @@ -7070,7 +6144,6 @@ appendix \family typewriter \backslash - authorrunning \end_layout @@ -7103,18 +6176,14 @@ object{} \family typewriter \backslash - -titlerunning -{} +titlerunning{} \end_layout \begin_layout Standard If you want to use any of these commands, you have to enter them yourself. \series bold -Do not forget to mark them as -LaTeX - code! +Do not forget to mark them as LaTeX code! \end_layout \begin_layout Subsection @@ -7212,9 +6281,7 @@ Fill \end_layout \begin_layout Enumerate -Switch to -LaTeX - mode: +Switch to LaTeX mode: \family sans M-c \begin_inset space ~ @@ -7230,11 +6297,7 @@ Enter \family typewriter \backslash - -parbox -[b]{ -55mm -}{ +parbox[b]{55mm}{ \family default . @@ -7243,9 +6306,8 @@ Do not close the brace! \end_layout \begin_layout Enumerate -Position the cursor behind the caption text, switch to -LaTeX - mode and insert the closing brace: +Position the cursor behind the caption text, switch to LaTeX mode and insert + the closing brace: \family sans M-c \begin_inset space ~ @@ -7269,16 +6331,13 @@ Referee layout \end_layout \begin_layout Standard -For submission, the paper has to be -formated - in a special double-spacing layout. +For submission, the paper has to be formated in a special double-spacing + layout. For this purpose, you have to give the option \family typewriter referee \family default - to the -documentclass -. + to the documentclass. This must be done using the extra class options field in the \family sans Document\SpecialChar \menuseparator @@ -7304,21 +6363,18 @@ Examples directory contains an example paper written with LyX. It is the example paper from the original macro package, translated to LyX. - Use it for inspiration, and compare the original -LaTeX - code with LyX way of writing. + Use it for inspiration, and compare the original LaTeX code with LyX way + of writing. \end_layout \begin_layout Section - AASTeX \end_layout \begin_layout Standard by \noun on -Mike -Ressler +Mike Ressler \end_layout \begin_layout Subsection @@ -7326,28 +6382,18 @@ Introduction \end_layout \begin_layout Standard - -AASTeX - is a set of macros produced by the American Astronomical Society to facilitate - electronic manuscript submission to the three journals they publish: the - Astrophysical Journal (including the Letters and Supplement), the Astronomical - Journal, and the Publications of the Astronomical Society of the Pacific. - LyX has -proven - to be an excellent tool for generating these documents, especially given - its equation, citation, and figure handling capabilities. +AASTeX is a set of macros produced by the American Astronomical Society + to facilitate electronic manuscript submission to the three journals they + publish: the Astrophysical Journal (including the Letters and Supplement), + the Astronomical Journal, and the Publications of the Astronomical Society + of the Pacific. + LyX has proven to be an excellent tool for generating these documents, + especially given its equation, citation, and figure handling capabilities. LyX requires version 5.0 (or higher) of these macros; preferably 5.2, which is the version described here, or higher. - Versions prior to 5.0 are intended for use with -LaTeX2 -. -09 - and are fundamentally incompatible with LyX. - The -AASTeX - package may be downloaded from the -AASTeX - Web site + Versions prior to 5.0 are intended for use with LaTeX2.09 and are fundamentally + incompatible with LyX. + The AASTeX package may be downloaded from the AASTeX Web site \end_layout \begin_layout Standard @@ -7382,13 +6428,11 @@ http://www.journals.uchicago.edu/AAS/AASTeX \begin_layout Standard A complete user guide is contained in that package and you should familiarize yourself with it thoroughly before embarking on writing a paper in LyX. - LyX will not reduce the need to figure out all the -AASTeX - commands, it will only reduce the drudgery of typing everything in. - It is your responsibility to ensure that the final exported -LaTeX - document conforms completely to the requirements of the journal to which - you are submitting your paper. + LyX will not reduce the need to figure out all the AASTeX commands, it + will only reduce the drudgery of typing everything in. + It is your responsibility to ensure that the final exported LaTeX document + conforms completely to the requirements of the journal to which you are + submitting your paper. \end_layout \begin_layout Subsection @@ -7396,9 +6440,7 @@ Starting a New Paper \end_layout \begin_layout Standard -I strongly suggest that you start with the -AASTeX - template file. +I strongly suggest that you start with the AASTeX template file. Click on \family sans File\SpecialChar \menuseparator @@ -7410,9 +6452,7 @@ Template \family default , enter the new file name, then choose the \family typewriter -aastex -. -lyx +aastex.lyx \family default template. This will show the most common fields found in a manuscript. @@ -7421,32 +6461,26 @@ lyx <> \family default ) with the correct information. - Many of the -AASTeX - commands and environments can be implemented directly in LyX, but some - cannot: most noticeably + Many of the AASTeX commands and environments can be implemented directly + in LyX, but some cannot: most noticeably \family typewriter \backslash - altaffilmark \family default and \family typewriter \backslash - altaffiltext \family default , which should stick out like a sore thumb if you actually just opened the template file. - For commands such as these, the -LaTeX - code must be entered directly and marked as such. + For commands such as these, the LaTeX code must be entered directly and + marked as such. Such commands are referred to as TeX code, or Evil Red Text. - I tried to minimize the amount of TeX code needed in an -AASTeX - document, but there is still a bit more required than any of us would like. + I tried to minimize the amount of TeX code needed in an AASTeX document, + but there is still a bit more required than any of us would like. \end_layout \begin_layout Subsection @@ -7459,9 +6493,7 @@ When the paper is finished to your satisfaction and previews/prints correctly, \begin_inset Quotes eld \end_inset - postprocessing - \begin_inset Quotes erd \end_inset @@ -7470,13 +6502,10 @@ postprocessing \end_layout \begin_layout Enumerate -Export your paper as a -LaTeX - file ( +Export your paper as a LaTeX file ( \family sans File\SpecialChar \menuseparator Export\SpecialChar \menuseparator - LaTeX \family default ). @@ -7486,8 +6515,7 @@ LaTeX \begin_layout Enumerate Edit the resulting \family typewriter -. -tex +.tex \family default file with your favorite text editor \end_layout @@ -7498,7 +6526,6 @@ remove the comment lines before the \family typewriter \backslash - documentclass \family default command @@ -7509,24 +6536,18 @@ remove the \family typewriter \backslash - -usepackage -...{ -fontenc -} +usepackage...{fontenc} \family default line if it appears (usually just after \family typewriter \backslash - documentclass \family default }; also remove the \family typewriter \backslash - secnumdepth \family default line if it appears. @@ -7537,47 +6558,38 @@ remove everything between (and including) the \family typewriter \backslash - makeatletter \family default and \family typewriter \backslash - makeatother \family default - commands, except for any commands you specifically put into the -LaTeX - preamble (which should appear immediately after the + commands, except for any commands you specifically put into the LaTeX preamble + (which should appear immediately after the \begin_inset Quotes eld \end_inset -User specified -LaTeX - commands +User specified LaTeX commands \begin_inset Quotes erd \end_inset comment in the \family typewriter -. -tex +.tex \family default file). \end_layout \end_deeper \begin_layout Enumerate -Run the resulting file through -LaTeX - to make sure it still processes correctly. +Run the resulting file through LaTeX to make sure it still processes correctly. \end_layout \begin_layout Enumerate -Reread the journal requirements to make sure your -filenames - and formats are correct. +Reread the journal requirements to make sure your filenames and formats + are correct. \end_layout \begin_layout Enumerate @@ -7589,15 +6601,10 @@ Comments On Specific Commands \end_layout \begin_layout Standard -I will not describe the detailed usage of the individual -AASTeX - commands: the -AASTeX - User Guide ( +I will not describe the detailed usage of the individual AASTeX commands: + the AASTeX User Guide ( \family typewriter -aasguide -. -tex +aasguide.tex \family default ) gives a good description of each. Thus it's probably easiest for me to go down the list as found in the guide @@ -7632,7 +6639,6 @@ Because they work as you might expect, I simply list them and the section \family typewriter \backslash - documentclass \family default (2.1.1), @@ -7657,7 +6663,6 @@ author \family typewriter \backslash - affil \family default (2.3), @@ -7688,7 +6693,6 @@ subsection \family typewriter \backslash - subsubsection \family default (2.7), @@ -7703,139 +6707,92 @@ paragraph \backslash facility \family default - (2. -10 -), + (2.10), \family typewriter \backslash -begin{ -displaymath -} +begin{displaymath} \family default - (2. -12 -), + (2.12), \family typewriter \backslash begin{equation} \family default - (2. -12 -), + (2.12), \family typewriter \backslash -begin{ -eqnarray -} +begin{eqnarray} \family default - (2. -12 -), + (2.12), \family typewriter \backslash -begin{ -mathletters -} +begin{mathletters} \family default - (2. -12 -), + (2.12), \family typewriter \backslash -begin{ -thebibliography -} +begin{thebibliography} \family default - (2. -13 -.1), + (2.13.1), \family typewriter \backslash - bibitem \family default - (2. -13 -.2), all the cite commands and their variations (2. -13 -.2), the generic -graphicx - figure commands (2. -14 -.1), + (2.13.2), all the cite commands and their variations (2.13.2), the generic + graphicx figure commands (2.14.1), \family typewriter \backslash begin{table} \family default - (2. -15 -.4), + (2.15.4), \family typewriter \backslash begin{tabular} \family default - (2. -15 -.4), + (2.15.4), \family typewriter \backslash caption \family default - (2. -15 -.4), + (2.15.4), \family typewriter \backslash label \family default - (2. -15 -.4, amongst other places), + (2.15.4, amongst other places), \family typewriter \backslash - tablerefs \family default - (2. -15 -.5), + (2.15.5), \family typewriter \backslash - tablecomments \family default - (2. -15 -.5), + (2.15.5), \family typewriter \backslash - url \family default - (2. -17 -.4), + (2.17.4), \family typewriter \backslash end{document} \family default - (2. -18 -). + (2.18). \end_layout \begin_layout Standard @@ -7898,9 +6855,7 @@ The following items work, but require a little more discussion: \begin_layout Itemize These items are reserved for use by the journal editors, but you can put - them into the -LaTeX - preamble if you feel compelled to do so: + them into the LaTeX preamble if you feel compelled to do so: \family typewriter \backslash @@ -7922,41 +6877,35 @@ accepted \family typewriter \backslash - ccc \family default , \family typewriter \backslash - cpright \family default (all from 2.1.3) \end_layout \begin_layout Itemize -These items may be placed in the -LaTeX - preamble, and are included as blanks in the template file: +These items may be placed in the LaTeX preamble, and are included as blanks + in the template file: \family typewriter \backslash - slugcomment \family default (2.1.4), \family typewriter \backslash - shorttitle \family default (2.1.5), \family typewriter \backslash - shortauthors \family default (2.1.5) @@ -7997,7 +6946,6 @@ and \family typewriter \backslash - notetoeditor \family default (2.6) – can only be used @@ -8017,7 +6965,6 @@ standalone \family typewriter \backslash - placetable \family default (2.8) – can't insert a cross-reference tag, you must type the tag name by @@ -8029,14 +6976,12 @@ placetable \family typewriter \backslash - placefigure \family default (2.8) – same as for \family typewriter \backslash - placetable \end_layout @@ -8045,7 +6990,6 @@ placetable \family typewriter \backslash - acknowledgements \family default (2.9) – will have extra {} after it. @@ -8059,9 +7003,7 @@ acknowledgements \backslash appendix \family default - (2. -11 -) – will have extra {} after it. + (2.11) – will have extra {} after it. This should not cause an error. \end_layout @@ -8070,15 +7012,10 @@ appendix \family typewriter \backslash - figcaption \family default - (2. -14 -.2) – you can insert an optional -filename - argument by placing the cursor at the beginning of the text and selecting - + (2.14.2) – you can insert an optional filename argument by placing the cursor + at the beginning of the text and selecting \family sans Insert\SpecialChar \menuseparator Short Title @@ -8096,7 +7033,6 @@ Short Title \family typewriter \backslash - figcaption \family default . @@ -8108,16 +7044,12 @@ figcaption \family typewriter \backslash - objectname \family default - (2. -17 -.1) – same as + (2.17.1) – same as \family typewriter \backslash - figcaption \family default for the catalog ID optional parameter @@ -8128,16 +7060,12 @@ figcaption \family typewriter \backslash - dataset \family default - (2. -17 -.1) – same as + (2.17.1) – same as \family typewriter \backslash - figcaption \family default for the catalog ID optional parameter @@ -8168,133 +7096,92 @@ begin{sloppypar} \family typewriter \backslash - altaffilmark \family default (2.3), \family typewriter \backslash - altaffiltext \family default (2.3), \family typewriter \backslash - eqnum \family default - (2. -12 -), + (2.12), \family typewriter \backslash - -setcounter -{equation} +setcounter{equation} \family default - (2. -12 -), Journal name abbreviations (2. -13 -.4), + (2.12), Journal name abbreviations (2.13.4), \family typewriter \backslash - figurenum \family default - (2. -14 -.1), + (2.14.1), \family typewriter \backslash - epsscale \family default - (2. -14 -.1), + (2.14.1), \family typewriter \backslash - plotone \family default - (2. -14 -.1), + (2.14.1), \family typewriter \backslash - plottwo \family default - (2. -14 -.1), + (2.14.1), \family typewriter \backslash - tablenum \family default - (2. -15 -.4), + (2.15.4), \family typewriter \backslash - tableline \family default - (2. -15 -.4, insert it as the first element in the -lefthand - cell after where you want it. + (2.15.4, insert it as the first element in the lefthand cell after where + you want it. Don't use any of LyX's rules in the table), \family typewriter \backslash - tablenotemark \family default - (2. -15 -.5), + (2.15.5), \family typewriter \backslash - tablenotetext \family default - (2. -15 -.5), much of Misc (2. -17 -, except + (2.15.5), much of Misc (2.17, except \family typewriter \backslash - objectname \family default , \family typewriter \backslash - dataset \family default , \family typewriter \backslash - url \family default , and @@ -8307,28 +7194,24 @@ email \family typewriter \backslash - singlespace \family default (3.1), \family typewriter \backslash - doublespace \family default (3.1), \family typewriter \backslash - onecolumn \family default (3.2), \family typewriter \backslash - twocolumn \family default (3.2) @@ -8357,17 +7240,10 @@ Things that cannot be implemented \begin_layout Standard \SpecialChar \ldots{} at least in any meaningful sort of way, so I suggest ignoring them. - They are the references environment (2. -13 -.3), and the -deluxetable - environment (2. -15 -). - If you really, really need to use -deluxetable -, I suggest editing it in a separate file with a text editor, then using - + They are the references environment (2.13.3), and the deluxetable environment + (2.15). + If you really, really need to use deluxetable, I suggest editing it in + a separate file with a text editor, then using \family sans Insert\SpecialChar \menuseparator Child @@ -8379,9 +7255,7 @@ Document to include it in your LyX document. See the \family typewriter -aas -_sample. -lyx +aas_sample.lyx \family default file to see an example of this. \end_layout @@ -8391,9 +7265,7 @@ FAQs, Tips, Tricks, and Other Ruminations \end_layout \begin_layout Subsubsection -Getting LyX and -AASTeX - to cooperate +Getting LyX and AASTeX to cooperate \end_layout \begin_layout Standard @@ -8403,27 +7275,11 @@ It can be a bit tricky to get LyX to recognize a new layout and document \end_layout \begin_layout Enumerate -Make certain that -LaTeX - can find -AASTeX -. - Copy sample. -tex - (and perhaps table. -tex -) from the -AASTeX - distribution into a directory completely unrelated to -LaTeX - or -AASTeX - and run -LaTeX - on +Make certain that LaTeX can find AASTeX. + Copy sample.tex (and perhaps table.tex) from the AASTeX distribution into + a directory completely unrelated to LaTeX or AASTeX and run LaTeX on \family typewriter -sample. -tex +sample.tex \family default . \end_layout @@ -8431,8 +7287,7 @@ tex \begin_layout Enumerate Make certain that \family typewriter -aastex -.layout +aastex.layout \family default appears in LyX's \family typewriter @@ -8452,9 +7307,7 @@ Reconfigure \begin_layout Enumerate Open a regular new file, not from a template. - Does -AASTeX - appear in the class list in + Does AASTeX appear in the class list in \family sans Document\SpecialChar \menuseparator Settings @@ -8463,11 +7316,8 @@ Settings \end_layout \begin_layout Standard -If you get a warning from an existing -AASTeX - document about not being able to find the -AASTeX - layout or a message about +If you get a warning from an existing AASTeX document about not being able + to find the AASTeX layout or a message about \begin_inset Quotes eld \end_inset @@ -8479,16 +7329,13 @@ You should not mix title layouts with normal ones \end_layout \begin_layout Subsubsection - -LaTeX - error processing a table +LaTeX error processing a table \end_layout \begin_layout Standard LyX, by default, attempts to center the table caption/title. - This seems to produce a bad interaction in -AASTeX - so you should click somewhere in the caption/title, then select + This seems to produce a bad interaction in AASTeX so you should click somewhere + in the caption/title, then select \family sans Edit\SpecialChar \menuseparator Paragraph @@ -8535,17 +7382,11 @@ g. \emph default type \family typewriter -Ressler -( -1992 -) +Ressler(1992) \family default , not \family typewriter -Ressler - ( -1992 -) +Ressler (1992) \family default . 2) Entering the references at all is not obvious. @@ -8562,31 +7403,22 @@ References \end_layout \begin_layout Subsubsection -Including -EPS - files +Including EPS files \end_layout \begin_layout Standard -Even though -AASTeX - provides its own figure commands ( +Even though AASTeX provides its own figure commands ( \family typewriter \backslash - plotone \family default -, for example), I much prefer -LaTeX's - standard figure commands (with the default -graphicx -). +, for example), I much prefer LaTeX's standard figure commands (with the + default graphicx). You can insert the \family typewriter \backslash - plotone \family default , etc. @@ -8599,22 +7431,12 @@ commands as TeX code into a Figure Float box if you desire, but I never \family typewriter \backslash - -usepackage -{ -graphicx -} +usepackage{graphicx} \family default - command into the -LaTeX - preamble and handle the figures in the standard -LaTeX2e - way, interspersing the figures in the text. - I believe -ApJ - accepts figures exactly this way now; -AJ - might still use the + command into the LaTeX preamble and handle the figures in the standard + LaTeX2e way, interspersing the figures in the text. + I believe ApJ accepts figures exactly this way now; AJ might still use + the \begin_inset Quotes eld \end_inset @@ -8641,10 +7463,7 @@ pretty things I could have implemented, but chose not to. For instance, I saw no point in double-spacing the text in the LyX window, even though it is double-spaced in the paper manuscript. - Also, I chose not to make separate layouts for the -preprint - and -preprint2 + Also, I chose not to make separate layouts for the preprint and preprint2 styles. Since I assume you will spend most of your time in the plain manuscript mode anyway, I decided not to chew up more disk space with this. @@ -8657,25 +7476,16 @@ Final Caveat \begin_layout Standard Your mileage may vary. - I've now had papers published by both -ApJ - and -AJ - that have had -98 -% of the effort done in LyX; the last 2% was the -LaTeX - post-processing and a few cleanups. + I've now had papers published by both ApJ and AJ that have had 98% of the + effort done in LyX; the last 2% was the LaTeX post-processing and a few + cleanups. I have had no trouble with the submission process, and I'm sure the journals were never aware that there might be a difference. So, go forth and publish! \end_layout \begin_layout Section - -AMS - -LaTeX +AMS LaTeX \end_layout \begin_layout Standard @@ -8693,17 +7503,12 @@ David Johnson; updated by Richard Heck \begin_layout Standard \noindent -The -AMS - -LaTeX - layouts are set up to conform to suggested styles for mathematical papers - to be submitted to American Mathematical Society publications. +The AMS LaTeX layouts are set up to conform to suggested styles for mathematical + papers to be submitted to American Mathematical Society publications. The layouts are not tailored to a specific journal, but easily can be. - You should refer to the -AMS - documentation for specific instructions for each journal (usually it will - entail only changing a single line in the TeX output). + You should refer to the AMS documentation for specific instructions for + each journal (usually it will entail only changing a single line in the + TeX output). That documentation is available on the Web at \begin_inset Flex URL status open @@ -8732,51 +7537,34 @@ ftp://ftp.ams.org/pub/tex/amslatex/ \end_layout \begin_layout Standard -There are two basic -AMS - -LaTeX - layouts: +There are two basic AMS LaTeX layouts: \end_layout \begin_layout Itemize - -amsart -: The standard -AMS - article format. +amsart: The standard AMS article format. \end_layout \begin_layout Itemize - -amsbook -: the standard -AMS - book (really, monograph) format. +amsbook: the standard AMS book (really, monograph) format. \end_layout \begin_layout Standard -The layouts themselves contain only the minimum necessary to use the -AMS +The layouts themselves contain only the minimum necessary to use the AMS classes. - They do not, in particular, contain any of the ` -theorem' - environments used for setting theorems, lemmas, and the like. + They do not, in particular, contain any of the `theorem' environments used + for setting theorems, lemmas, and the like. These are contained, instead, in the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Theorems ( -AMS -) +Theorems (AMS) \end_layout \end_inset - module, which is loaded by default when when you select one of the -AMS + module, which is loaded by default when when you select one of the AMS classes. (It can also be used with other classes and can be removed, if you would rather use something else.) Less commonly used environments are in the @@ -8784,9 +7572,7 @@ AMS status collapsed \begin_layout Plain Layout -Theorems ( -AMS --Extended) +Theorems (AMS-Extended) \end_layout \end_inset @@ -8811,9 +7597,7 @@ Theorems (Order by Section) status collapsed \begin_layout Plain Layout -book ( -AMS -) +book (AMS) \end_layout \end_inset @@ -8859,17 +7643,13 @@ Note that these modules do not \emph on have \emph default - to be used with the -AMS - classes. + to be used with the AMS classes. It is perfectly possible to use the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Theorems ( -AMS -) +Theorems (AMS) \end_layout \end_inset @@ -8899,9 +7679,7 @@ report status collapsed \begin_layout Plain Layout -book ( -KOMA --script) +book (KOMA-script) \end_layout \end_inset @@ -8915,16 +7693,9 @@ What these layouts provide \begin_layout Standard There is a long list of included environments provided by these layouts. - In -AMS -- -LaTeX -, there is, in fact, an opportunity to define an unlimited variety of ` -theorem' - environments. - However, the -AMS - recommends the environments that are available in LyX. + In AMS-LaTeX, there is, in fact, an opportunity to define an unlimited + variety of `theorem' environments. + However, the AMS recommends the environments that are available in LyX. \end_layout @@ -8985,9 +7756,7 @@ date status collapsed \begin_layout Plain Layout -article ( -AMS -) +article (AMS) \end_layout \end_inset @@ -8997,9 +7766,7 @@ AMS status collapsed \begin_layout Plain Layout -book ( -AMS -) +book (AMS) \end_layout \end_inset @@ -9034,20 +7801,13 @@ Keywords Key words or phrases used to identify specific topics discussed \end_layout \begin_layout Description - -Subjectclass - These refer to the -AMS - Subject Classifications, published and described in +Subjectclass These refer to the AMS Subject Classifications, published and + described in \emph on Mathematical Reviews \emph default . - These are also available -online - at the -AMS - cites listed above. + These are also available online at the AMS cites listed above. \end_layout \begin_layout Description @@ -9078,15 +7838,12 @@ Theorems status collapsed \begin_layout Plain Layout -Theorems ( -AMS -) +Theorems (AMS) \end_layout \end_inset - modules, in the latter case in both starred (unnumbered) and -unstarred + modules, in the latter case in both starred (unnumbered) and unstarred (numbered) versions. These same environments are provided only in the starred versions by the @@ -9135,9 +7892,7 @@ Guess what this is for. \end_layout \begin_layout Example* -Used for examples illustrating -proven - results. +Used for examples illustrating proven results. \end_layout \begin_layout Problem @@ -9192,9 +7947,7 @@ And these environments are provided by status collapsed \begin_layout Plain Layout -Theorems ( -AMS --Extended) +Theorems (AMS-Extended) \end_layout \end_inset @@ -9232,9 +7985,7 @@ Do we really need to tell you? \end_layout \begin_layout Acknowledgement* - -Acknowledgement -. +Acknowledgement. \end_layout \begin_layout Conclusion* @@ -9246,22 +7997,13 @@ Used in a way similar to Proposition, though perhaps lower on the scale. \end_layout \begin_layout Standard -In addition, the -AMS - classes automatically provide the -AMS - -LaTeX - and -AMS +In addition, the AMS classes automatically provide the AMS LaTeX and AMS fonts packages. They need to be available on your system in order to use these environments. \end_layout \begin_layout Section - -AGU - journals ( +AGU journals ( \family sans aguplus \family default @@ -9281,10 +8023,7 @@ Description \begin_layout Standard These are the layout files for some of the journals of the American Geophysical Society. - It is assumed that you have both the -AGU's - own class files and -AGUplus + It is assumed that you have both the AGU's own class files and AGUplus installed (everything to be found at \begin_inset Flex URL status collapsed @@ -9313,18 +8052,14 @@ Paragraph Paragraph* \family default . - They are still called this in the LyX GUI, though their -LaTeX - equivalents in the -AGU - classes are + They are still called this in the LyX GUI, though their LaTeX equivalents + in the AGU classes are \family sans Subsubsubsection \family default and \family sans -Subsubsubsection -* +Subsubsubsection* \family default . \end_layout @@ -9367,9 +8102,8 @@ AuthorAddr SlugComment \family default . - These are mostly manuscript attributes and defined in the -AGU - class documentation. + These are mostly manuscript attributes and defined in the AGU class documentati +on. \end_layout \begin_layout Standard @@ -9408,8 +8142,7 @@ Journal of Geophysical Research \emph default : \family typewriter -jgrga -.layout +jgrga.layout \family default — Martin Vermeer \end_layout @@ -9417,13 +8150,11 @@ jgrga \begin_layout Standard Add your own, it isn't so hard! Look at the \family typewriter -jgrga -.layout +jgrga.layout \family default example and \family typewriter -aguplus -.inc +aguplus.inc \family default . \end_layout @@ -9454,9 +8185,7 @@ Document\SpecialChar \menuseparator Settings \family default menu item. - ( -AGU - articles are always in English, right? So + (AGU articles are always in English, right? So \emph on don't \emph default @@ -9479,17 +8208,13 @@ Extra Options \begin_layout Enumerate Make sure you use the \family typewriter -agu -. -bst +agu.bst \family default bibliography style, by entering \family sans agu \family default - into the second field of the -BibTeX - inset. + into the second field of the BibTeX inset. None of the standard styles will do. \end_layout @@ -9500,8 +8225,7 @@ Broadway \begin_layout Standard by \shape smallcaps -Garst - Reese +Garst Reese \end_layout \begin_layout Subsection @@ -9540,16 +8264,7 @@ Paper size and Margins \end_layout \begin_layout Standard - -USLetter -, left 1. -6in -, right 0. -75in -, top 0. -5in -, bottom 0. -75in +USLetter, left 1.6in, right 0.75in, top 0.5in, bottom 0.75in \end_layout \begin_layout Subsection @@ -9558,9 +8273,7 @@ Environments \begin_layout Standard The following environments are available. - You can use -broadway -.bind to get the bind keys shown at the right. + You can use broadway.bind to get the bind keys shown at the right. \end_layout \begin_layout Itemize @@ -9590,9 +8303,7 @@ M-z n \family default Used to describe stage setting and the action. - First use of speaker names in all -CAPs -. + First use of speaker names in all CAPs. \end_layout \begin_layout Itemize @@ -9609,9 +8320,7 @@ M-z a \family default Automatically numbered. - On screen it will be -arabic -, but will print as Roman. + On screen it will be arabic, but will print as Roman. \end_layout \begin_layout Itemize @@ -9713,7 +8422,6 @@ Dialogue \family sans Dialogue - \begin_inset space \hfill{} \end_inset @@ -9777,7 +8485,6 @@ Hello there. \end_layout \begin_layout Section - Dinbrief \end_layout @@ -9789,17 +8496,13 @@ dinbrief can be used to type letters according to German conventions. A template file is included in \family typewriter -.../ -lyx -/share/templates +.../lyx/share/templates \family default for you to use as a starting point. \end_layout \begin_layout Section - -EGS - journals ( +EGS journals ( \family sans egs \family default @@ -9820,13 +8523,9 @@ Description This is the layout file for the European Geophysical Society journals. The needed \family typewriter -egs -. -cls +egs.cls \family default - can be downloaded from the web site of the -EGS - under + can be downloaded from the web site of the EGS under \begin_inset Flex URL status collapsed @@ -9847,22 +8546,16 @@ New styles \begin_layout Standard \family sans -Right_address, Latex_Title, -Affil -, Journal, -msnumber -, -FirstAuthor -, Received, Accepted +Right_address, Latex_Title, Affil, Journal, msnumber, FirstAuthor, Received, + Accepted \family default , \family sans Offsets \family default . - The current layout file is unfortunately very -unmodular - and would benefit from using the various + The current layout file is unfortunately very unmodular and would benefit + from using the various \family typewriter std*.inc \family default @@ -9870,29 +8563,20 @@ std*.inc \end_layout \begin_layout Section - -Elsevier - Journals +Elsevier Journals \end_layout \begin_layout Standard By \noun on -Rod -Pinna +Rod Pinna \end_layout \begin_layout Standard - -Elsevier - Science Publishers B.V. - provides a standard -LaTeX - document class ( +Elsevier Science Publishers B.V. + provides a standard LaTeX document class ( \family typewriter -elsart -. -cls +elsart.cls \family default ) for submitting articles to their various journals. The style file can be downloaded directly from their web site: @@ -9911,55 +8595,36 @@ http://authors.elsevier.com/ requirements of the publishers. LyX includes package that allows for the use of this class, by a layout and a template file. - Installation of the class file is the same as for any other -LaTeX - package; instructions are provided in the -Elsevier - documentation. + Installation of the class file is the same as for any other LaTeX package; + instructions are provided in the Elsevier documentation. \end_layout \begin_layout Standard To make use of \family typewriter -elsart -. -cls +elsart.cls \family default , a file \family typewriter -elsart -.layout +elsart.layout \family default is supplied. - As the -Elsevier - class file is based mainly on the standard article class, most of the normal - functionality is provided. - The -Elsevier - class defines a number of mathematical environments, which are similar - to the -AMS - environments. - These commands are all described in the -Elsevier - documentation, and are available in LyX. + As the Elsevier class file is based mainly on the standard article class, + most of the normal functionality is provided. + The Elsevier class defines a number of mathematical environments, which + are similar to the AMS environments. + These commands are all described in the Elsevier documentation, and are + available in LyX. \end_layout \begin_layout Standard -The easiest way to use the -Elsevier - style is to base documents on the included template file. +The easiest way to use the Elsevier style is to base documents on the included + template file. It is best not to use options such as fancy headings or the geometry package, - as elements such as these are defined by -Elsevier - in their style file. - Ideally, no extra packages except those mentioned in the -Elsevier - documentation should be used. - Essentially, -Elsevier - require as + as elements such as these are defined by Elsevier in their style file. + Ideally, no extra packages except those mentioned in the Elsevier documentation + should be used. + Essentially, Elsevier require as \begin_inset Quotes eld \end_inset @@ -9967,20 +8632,15 @@ clean \begin_inset Quotes erd \end_inset - a -LaTeX - file as possible, as their intention is to take the supplied file and replace - the class file with one for the particular journal to which the paper has - been submitted. - This also means that not too much time should be spent on the -formating + a LaTeX file as possible, as their intention is to take the supplied file + and replace the class file with one for the particular journal to which + the paper has been submitted. + This also means that not too much time should be spent on the formating of the document. When it comes to be published, this will change anyway. The rest of the usage for this layout is substantially the same as for the normal article class. - For details of what -Elsevier - do and don't allow, refer to their documentation. + For details of what Elsevier do and don't allow, refer to their documentation. \end_layout \begin_layout Section @@ -10041,9 +8701,7 @@ This section documents the class \family sans -slides ( -FoilTeX -) +slides (FoilTeX) \family default \begin_inset Quotes erd @@ -10096,9 +8754,7 @@ foils \family sans -slides ( -FoilTeX -) +slides (FoilTeX) \family default \begin_inset Quotes erd @@ -10120,14 +8776,9 @@ foils \family default class is designed for use with version 2.1 of the \family sans -foils. -cls +foils.cls \family default - -LaTeX - class file which is now an integral part of -LaTeX2e -. + LaTeX class file which is now an integral part of LaTeX2e. \end_layout \begin_layout Subsection @@ -10141,9 +8792,7 @@ Obviously, to use this document class, you need to select \family sans -slides ( -FoilTeX -) +slides (FoilTeX) \family default \begin_inset Quotes erd @@ -10199,27 +8848,19 @@ foils \end_layout \begin_layout Itemize -The default font size is -20 - +The default font size is 20 \begin_inset space \thinspace{} \end_inset -pt with the other options being -17 - +pt with the other options being 17 \begin_inset space \thinspace{} \end_inset -pt, -25 - +pt, 25 \begin_inset space \thinspace{} \end_inset -pt and -30 - +pt and 30 \begin_inset space \thinspace{} \end_inset @@ -10243,20 +8884,13 @@ serif \family sans FoilTeX \family default - supports -A4 - and Letter paper sizes as well as a special size for working with -35 - + supports A4 and Letter paper sizes as well as a special size for working + with 35 \begin_inset space \thinspace{} \end_inset mm slides. - It doesn't support -A5 -, -B5 -, legal or executive paper sizes. + It doesn't support A5, B5, legal or executive paper sizes. \end_layout \begin_layout Itemize @@ -10383,21 +9017,15 @@ Settings \series bold 35mmSlide \series default - This sets up the page layout for 7. -33 - + This sets up the page layout for 7.33 \begin_inset space \thinspace{} \end_inset -in by -11 - +in by 11 \begin_inset space \thinspace{} \end_inset -in paper, which is about the same aspect ratio as a -35 - +in paper, which is about the same aspect ratio as a 35 \begin_inset space \thinspace{} \end_inset @@ -10439,9 +9067,8 @@ foils \family sans FoilTeX \family default - to use the -dvips - driver to rotate those pages that are set as landscape foils. + to use the dvips driver to rotate those pages that are set as landscape + foils. \end_layout \begin_layout Labeling @@ -10792,9 +9419,7 @@ end{multicols} \end_layout \begin_layout Standard -The starred versions are unnumbered while the -unstarred - versions are numbered. +The starred versions are unnumbered while the unstarred versions are numbered. There are also two list environments added by LyX and these are: \end_layout @@ -10830,9 +9455,7 @@ g. \emph default -straight after the -foilhead -. +straight after the foilhead. \end_layout \begin_layout Standard @@ -10959,8 +9582,7 @@ This section will give a simple introduction to using the different environments to build a set of foils. If you want to see an example set of foils, take a look at the \family typewriter -Foils. -lyx +Foils.lyx \family default file you find in LyX's \family typewriter @@ -10999,9 +9621,8 @@ foils \family sans Date \family default - environment -LaTeX - will substitute the current date (every time you regenerate the output). + environment LaTeX will substitute the current date (every time you regenerate + the output). \end_layout \begin_layout Subsubsection @@ -11016,14 +9637,11 @@ Foilhead \family default or \family sans -ShortFoilhead -. +ShortFoilhead. \family default The difference between these two environments is the amount of space between - the title of the foil (the -foilhead -) and the body of the foil. + the title of the foil (the foilhead) and the body of the foil. \end_layout \begin_layout Standard @@ -11036,11 +9654,8 @@ Rotatefoilhead ShortRotatefoilhead \family default environments. - Again the only difference is the spacing between -foilhead - and body. - Both of the short versions have 0.5 inches less separation between the -foilhead + Again the only difference is the spacing between foilhead and body. + Both of the short versions have 0.5 inches less separation between the foilhead and the body. \end_layout @@ -11051,9 +9666,7 @@ One problem with the support for landscape foils is the requirement that \family typewriter dvips \family default - driver to generate the -PostScript - output otherwise the foils won't be rotated. + driver to generate the PostScript output otherwise the foils won't be rotated. It is possible to get landscape foils even if you haven't got the \family typewriter dvips @@ -11090,9 +9703,7 @@ LaTeX in it. This will force LyX to produce two separate environments and hence the - correct -LaTeX - output. + correct LaTeX output. An example is provided in the example file included with the LyX distribution. Remember, this problem only occurs if you are trying to place two of the same type of theorem-like environments one directly after the other. @@ -11148,10 +9759,7 @@ TickList \family sans CrossList \family default -, are designed to make it easier for you to create lists of -do's - and -don'ts +, are designed to make it easier for you to create lists of do's and don'ts or right and wrong by providing dedicated environments that use a tick or a cross as the label of the list. These lists are in fact dedicated variants of the @@ -11301,9 +9909,7 @@ All lengths are adjusted using the \family typewriter \backslash - -setlength -{ +setlength{ \family default \emph on lengthname @@ -11344,7 +9950,6 @@ pt \family typewriter \backslash - textwidth \family default . @@ -11352,13 +9957,11 @@ textwidth \end_layout \begin_layout Standard -It's possible to change the spacing between a -foilhead - and the body of the foil by adjusting the length specified by +It's possible to change the spacing between a foilhead and the body of the + foil by adjusting the length specified by \family typewriter \backslash - foilheadskip \family default . @@ -11366,9 +9969,7 @@ foilheadskip \emph on all \emph default - -foilheads - 0.5 + foilheads 0.5 \begin_inset space \space{} \end_inset @@ -11376,15 +9977,9 @@ in closer to their bodies put the following in the preamble: \family typewriter \backslash - -setlength -{ +setlength{ \backslash - -foilheadskip -}{-0. -5in -} +foilheadskip}{-0.5in} \end_layout \begin_layout Standard @@ -11397,7 +9992,6 @@ The spacings around floats can be adjusted by setting these lengths: \family typewriter \backslash - abovefloatskip \family default Separation between the text and the top of the float @@ -11409,7 +10003,6 @@ abovefloatskip \family typewriter \backslash - abovecaptionskip \family default Separation between the float and the caption @@ -11421,7 +10014,6 @@ abovecaptionskip \family typewriter \backslash - belowcaptionskip \family default Separation between the caption and the following text @@ -11433,7 +10025,6 @@ belowcaptionskip \family typewriter \backslash - captionwidth \family default You can make the captions narrower than the surrounding text by adjusting @@ -11442,7 +10033,6 @@ captionwidth \family typewriter \backslash - textwidth \family default . @@ -11459,7 +10049,6 @@ There are also several title page related lengths that you may find useful \family typewriter \backslash - abovetitleskip \family default Separation from headers to @@ -11473,7 +10062,6 @@ Title \family typewriter \backslash - titleauthorskip \family default between @@ -11493,7 +10081,6 @@ Author \family typewriter \backslash - authorauthorskip \family default between multiple @@ -11509,7 +10096,6 @@ Author \family typewriter \backslash - authordateskip \family default between the @@ -11527,7 +10113,6 @@ Date \family typewriter \backslash - dateabstractskip \family default between the @@ -11545,7 +10130,6 @@ The last length related command affects all the list environments. \family typewriter \backslash - zerolistvertdimens \family default @@ -11558,7 +10142,6 @@ inside \family typewriter \backslash - setlength \family default like the stuff mentioned above. @@ -11573,14 +10156,12 @@ The \family typewriter \backslash - LogoOn \family default and \family typewriter \backslash - LogoOff \family default commands control whether the logo in the @@ -11592,7 +10173,6 @@ MyLogo \family typewriter \backslash - LogoOff \family default in the preamble then none of the foils will have the logo on them. @@ -11600,21 +10180,15 @@ LogoOff \family typewriter \backslash - LogoOff \family default - directly after the -foilhead - of that page and the + directly after the foilhead of that page and the \family typewriter \backslash - LogoOn \family default - directly after the next -foilhead -. + directly after the next foilhead. \end_layout \begin_layout Standard @@ -11636,11 +10210,8 @@ Layout \backslash let \backslash - headwidth - \backslash - textwidth \family default to your preamble so headers and footers on landscape pages are correctly @@ -11663,8 +10234,7 @@ Hollywood (Hollywood spec scripts) \begin_layout Standard by \shape smallcaps -Garst - Reese +Garst Reese \end_layout \begin_layout Subsection @@ -11684,9 +10254,7 @@ rite of passage. familiar for the actors to read. Each page of a script should be one minute of film. Nothing goes in a script that you cannot see or hear on screen. - The courier -12 - pt font should be used throughout. + The courier 12 pt font should be used throughout. No italics. \end_layout @@ -11695,16 +10263,12 @@ Special problems \end_layout \begin_layout Standard - -Speakers' - lines should NEVER break in mid-sentence. +Speakers' lines should NEVER break in mid-sentence. If a speaker's lines continue over a page break, repeat the \family sans Speaker \family default - title followed by ( -Cont'd -). + title followed by (Cont'd). \end_layout \begin_layout Subsection @@ -11726,16 +10290,7 @@ Paper size and Margins \end_layout \begin_layout Standard - -USLetter -, left 1. -6in -, right 0. -75in -, top 0. -5in -, bottom 0. -75in +USLetter, left 1.6in, right 0.75in, top 0.5in, bottom 0.75in \end_layout \begin_layout Subsection @@ -11744,9 +10299,7 @@ Environments \begin_layout Standard The following environments are available. - You can use -hollywood -.bind to get the bind keys shown at the right. + You can use hollywood.bind to get the bind keys shown at the right. \end_layout \begin_layout Itemize @@ -11806,9 +10359,7 @@ M-z i Introduces a new INTERIOR camera set-up. Always followed by DAY or NIGHT, or something similar to define the lighting required. - -Everthing - on this line in CAPS. + Everthing on this line in CAPS. \end_layout \begin_layout Itemize @@ -11825,9 +10376,7 @@ M-z e \family default Introduces a new EXTERIOR camera set-up. - -Everthing - on this line in CAPS. + Everthing on this line in CAPS. \end_layout \begin_layout Itemize @@ -11868,7 +10417,6 @@ Instructions to the speaker. \family sans Dialogue - \begin_inset space \hfill{} \end_inset @@ -11985,18 +10533,13 @@ INSERT — cut to close-up of \end_layout \begin_layout Section - -ijmpc - and -ijmpd +ijmpc and ijmpd \end_layout \begin_layout Standard by \noun on -Panayotis - -Papasotiriou +Panayotis Papasotiriou \end_layout \begin_layout Subsection @@ -12004,17 +10547,14 @@ Overview \end_layout \begin_layout Standard -The -ijmpc - package is a set of macros that facilitates electronic manuscript submission - to the +The ijmpc package is a set of macros that facilitates electronic manuscript + submission to the \emph on International Journal of Modern Physics C \emph default . - Similarly, the -ijmpd - package is for creating manuscripts to be submitted to the + Similarly, the ijmpd package is for creating manuscripts to be submitted + to the \emph on International Journal of Modern Physics D \emph default @@ -12022,19 +10562,11 @@ International Journal of Modern Physics D Both journals are published by World Scientific. The corresponding document classes are named \family typewriter -ws -- -ijmpc -. -cls +ws-ijmpc.cls \family default and \family typewriter -ws -- -ijmpd -. -cls +ws-ijmpd.cls \family default , respectively. These files, together with instructions for the authors, can be downloaded @@ -12095,15 +10627,11 @@ emplate \family default , then choose the \family typewriter -ijmpc -. -lyx +ijmpc.lyx \family default or \family typewriter -ijmpd -. -lyx +ijmpd.lyx \family default template. This will give an (almost) empty document that includes the most common @@ -12137,9 +10665,7 @@ Lang Opts \family sans Use babel \family default - -checkbox - in the language settings, and click on + checkbox in the language settings, and click on \family sans Apply \family default @@ -12163,9 +10689,7 @@ Keywords \end_layout \begin_layout Enumerate -The -ijmpc - package provides a style named +The ijmpc package provides a style named \begin_inset Quotes eld \end_inset @@ -12173,12 +10697,8 @@ Classification Codes \begin_inset Quotes erd \end_inset -, which can be used to define classification codes, such as -PACS - numbers. - Note that this facility is not supported by the -ijmpd - package. +, which can be used to define classification codes, such as PACS numbers. + Note that this facility is not supported by the ijmpd package. \end_layout \begin_layout Enumerate @@ -12301,9 +10821,7 @@ Conjecture \end_layout \begin_layout Enumerate -Both packages use basic citations; the -natbib - package should not be used. +Both packages use basic citations; the natbib package should not be used. In LyX, citation references are shown as usual; in the output, citations are shown as superscripts. If you want to use a citation as normal text, you should use the @@ -12330,9 +10848,7 @@ See Ref. \family typewriter \backslash - -refcite -{key} +refcite{key} \family default \begin_inset Quotes erd @@ -12381,9 +10897,8 @@ Appendices Section \end_inset which marks the beginning of the appendices. - This environment should be left blank; it just sends a -LaTeX - command, but nothing is really printed. + This environment should be left blank; it just sends a LaTeX command, but + nothing is really printed. In LyX, the word \begin_inset Quotes eld \end_inset @@ -12422,11 +10937,7 @@ must \end_layout \begin_layout Enumerate -The -ijmpc - and the -ijmpd - packages use the +The ijmpc and the ijmpd packages use the \family typewriter tbl \family default @@ -12440,9 +10951,7 @@ tbl \family typewriter \backslash - -tbl -{ +tbl{ \emph on your table caption \emph default @@ -12458,8 +10967,7 @@ your table caption Alternatively, If you need table captions, you should implement the whole table float in a \family typewriter -. -tex +.tex \family default file, then include this file to the LyX document ( \family sans @@ -12474,19 +10982,11 @@ Document ). Details on how to create a table float can be found in the files \family typewriter -ws -- -ijmpc -. -tex +ws-ijmpc.tex \family default and \family typewriter -ws -- -ijmpd -. -tex +ws-ijmpd.tex \family default , included in the corresponding packages. \end_layout @@ -12496,13 +10996,11 @@ Preparing a paper for submission \end_layout \begin_layout Standard -Before you submit your paper you must export the LyX document as a -LaTeX +Before you submit your paper you must export the LyX document as a LaTeX file ( \family sans File\SpecialChar \menuseparator Export\SpecialChar \menuseparator - LaTeX \family default ) @@ -12510,28 +11008,17 @@ LaTeX status open \begin_layout Plain Layout -Actually you have the choice between -LaTeX - (plain) and -pdflatex -. - If you intend to use -pdflatex - to prepare the paper, you should use the -pdflatex - option so that included graphics are converted to -PDF - format, ready for use by -pdflatex -. +Actually you have the choice between LaTeX (plain) and pdflatex. + If you intend to use pdflatex to prepare the paper, you should use the + pdflatex option so that included graphics are converted to PDF format, + ready for use by pdflatex. \end_layout \end_inset , then make the following changes to the resulting \family typewriter -. -tex +.tex \family default file. \end_layout @@ -12541,7 +11028,6 @@ Remove the comment lines before the \family typewriter \backslash - documentclass \family default command. @@ -12552,34 +11038,26 @@ Remove everything between (and including) the \family typewriter \backslash - makeatletter \family default and \family typewriter \backslash - makeatother \family default - commands, except for any commands you specifically put into the -LaTeX - preamble. + commands, except for any commands you specifically put into the LaTeX preamble. \end_layout \begin_layout Standard The modified \family typewriter -. -tex +.tex \family default - file should be saved and processed through -LaTeX - as many times as necessary. + file should be saved and processed through LaTeX as many times as necessary. You may also want to check the resulting \family typewriter -. -dvi +.dvi \family default document. \end_layout @@ -12593,46 +11071,34 @@ The use of TeX code is reduced to two commands, which must be placed at the top of the document. If you started writing your paper by using the \family typewriter -ijmpc -. -lyx +ijmpc.lyx \family default or the \family typewriter -ijmpd -. -lyx +ijmpd.lyx \family default template, the TeX code needed is already in its place; you usually don't need to delete it. You may only modify the first TeX code to specify the information printed - to the top of odd and even pages ( -authors' - names and short paper's title, respectively). + to the top of odd and even pages (authors' names and short paper's title, + respectively). This TeX code must have the form \family typewriter \backslash - -markboth -{ -Authors' - Names}{Short Paper's Title} +markboth{Authors' Names}{Short Paper's Title} \family default . \end_layout \begin_layout Section - iopart \end_layout \begin_layout Standard by \noun on -Uwe - -Stöhr +Uwe Stöhr \end_layout \begin_layout Subsection @@ -12640,15 +11106,10 @@ Overview \end_layout \begin_layout Standard -The -iopart - package provides a document class to create electronic manuscript submission - to the journals published by the Institute of Physics. - Instructions for the authors how to create a paper using the -iopart - class can be downloaded together with the -iopart - package from the site +The iopart package provides a document class to create electronic manuscript + submission to the journals published by the Institute of Physics. + Instructions for the authors how to create a paper using the iopart class + can be downloaded together with the iopart package from the site \begin_inset Flex URL status collapsed @@ -12669,9 +11130,7 @@ Writing a paper \begin_layout Standard The easiest way to write a paper is to start with the file \emph on -IOP --article. -lyx +IOP-article.lyx \emph default that is available in LyX's examples files folder. Open this file, save it under a new name, and start writing. @@ -12680,15 +11139,10 @@ lyx \end_layout \begin_layout Itemize -To be able to compile your document to a -PDF -, PS, or -DVI -, assure that the two options +To be able to compile your document to a PDF, PS, or DVI, assure that the + two options \family sans -Use -AMS - math package +Use AMS math package \family default in the document settings under \family sans @@ -12808,24 +11262,18 @@ Article \end_layout \begin_layout Standard -For more -informations - like hints for special table and formula formatting, look at the -IOP - author guidelines. +For more informations like hints for special table and formula formatting, + look at the IOP author guidelines. \end_layout \begin_layout Section - Kluwer \end_layout \begin_layout Standard by \noun on -Panayotis - -Papasotiriou +Panayotis Papasotiriou \end_layout \begin_layout Subsection @@ -12833,12 +11281,9 @@ Overview \end_layout \begin_layout Standard -The -Kluwer - package is a set of macros produced by -Kluwer - Academic Publishers that facilitates electronic manuscript submission to - the journals they publish. +The Kluwer package is a set of macros produced by Kluwer Academic Publishers + that facilitates electronic manuscript submission to the journals they + publish. Most known of them (at least in my domain of interest) are \emph on Astrophysics and Space Science @@ -12859,9 +11304,7 @@ http://www.wkap.nl/jrnllist.htm/JRNLHOME \end_inset ). - The -Kluwer - package may be downloaded from the site + The Kluwer package may be downloaded from the site \begin_inset Flex URL status collapsed @@ -12911,9 +11354,7 @@ Writing a paper \end_layout \begin_layout Standard -The easiest way to write a paper is to start with the -Kluwer - template file. +The easiest way to write a paper is to start with the Kluwer template file. Click on \family sans File\SpecialChar \menuseparator @@ -12925,9 +11366,7 @@ Template \family default , then choose the \family typewriter -kluwer -. -lyx +kluwer.lyx \family default template. This will give an (almost) empty document that includes the most common @@ -12945,15 +11384,12 @@ Preparing a paper for submission \end_layout \begin_layout Standard -As in the -AASTeX - package, before you submit your paper to a journal you must +As in the AASTeX package, before you submit your paper to a journal you + must \begin_inset Quotes eld \end_inset - postprocess - \begin_inset Quotes erd \end_inset @@ -12961,14 +11397,11 @@ postprocess \end_layout \begin_layout Enumerate -Export your paper as a -LaTeX - file. +Export your paper as a LaTeX file. To do this, click on \family sans File\SpecialChar \menuseparator Export\SpecialChar \menuseparator - LaTeX \family default . @@ -12978,8 +11411,7 @@ LaTeX \begin_layout Enumerate Edit the resulting \family typewriter -. -tex +.tex \family default file with a text editor and make the following changes \end_layout @@ -12990,7 +11422,6 @@ remove the comment lines before the \family typewriter \backslash - documentclass \family default command, @@ -13001,26 +11432,21 @@ remove everything between (and including) the \family typewriter \backslash - makeatletter \family default and \family typewriter \backslash - makeatother \family default - commands, except for any commands you specifically put into the -LaTeX - preamble. + commands, except for any commands you specifically put into the LaTeX preamble. \end_layout \begin_layout Standard Save the resulting \family typewriter -. -tex +.tex \family default file. \end_layout @@ -13029,19 +11455,15 @@ tex \begin_layout Enumerate Run the \family typewriter -. -tex +.tex \family default - file through -LaTeX - as many times as necessary (usually up to three). + file through LaTeX as many times as necessary (usually up to three). \end_layout \begin_layout Enumerate View the resulting \family typewriter -. -dvi +.dvi \family default document using, e. \begin_inset space \thinspace{} @@ -13066,9 +11488,7 @@ Peculiarities \begin_inset Quotes erd \end_inset - of the -Kluwer - package + of the Kluwer package \begin_inset CommandInset label LatexCommand label name "subsec:kluwer_peculiarities" @@ -13079,9 +11499,7 @@ name "subsec:kluwer_peculiarities" \end_layout \begin_layout Standard -The -Kluwer - package has the following +The Kluwer package has the following \begin_inset Quotes eld \end_inset @@ -13093,9 +11511,7 @@ peculiarities \end_layout \begin_layout Enumerate -It is possible to write multiple articles in the same -LaTeX - file +It is possible to write multiple articles in the same LaTeX file \begin_inset Foot status collapsed @@ -13132,9 +11548,8 @@ end{article} . Although this can be implemented in LyX, I didn't included it, since it looks ugly and can confuse the novice user. - Therefore, you need to enter them directly and mark them as -LaTeX - code (the well-known + Therefore, you need to enter them directly and mark them as LaTeX code + (the well-known \begin_inset Quotes eld \end_inset @@ -13191,9 +11606,7 @@ According to the user manual, the label of each bibliography item must be \backslash protect \backslash - -citeauthoryear -{ +citeauthoryear{ \family default \emph on author(s) @@ -13213,9 +11626,7 @@ year \begin_layout Standard The \family typewriter -kluwer -. -lyx +kluwer.lyx \family default template takes care of all these \begin_inset Quotes eld @@ -13241,17 +11652,13 @@ copy the example bibliography item included in the template and modify it \end_layout \begin_layout Section - -Koma --Script +Koma-Script \end_layout \begin_layout Standard by \noun on -Bernd - -Rellermeyer +Bernd Rellermeyer \end_layout \begin_layout Subsection @@ -13261,15 +11668,11 @@ Overview \begin_layout Standard The LyX document classes \emph on -article ( -koma --script) +article (koma-script) \emph default , \emph on -report ( -koma --script) +report (koma-script) \emph default , \emph on @@ -13277,9 +11680,7 @@ book \emph default \emph on -( -koma --script) +(koma-script) \emph default , and \emph on @@ -13287,95 +11688,65 @@ letter \emph default \emph on -( -koma --script) +(koma-script) \emph default - correspond to the -LaTeX - document classes + correspond to the LaTeX document classes \family typewriter -scrartcl -. -cls +scrartcl.cls \family default , \family typewriter -scrreprt -. -cls +scrreprt.cls \family default , \family typewriter -scrbook -. -cls +scrbook.cls \family default , and \family typewriter -scrlettr -. -cls +scrlettr.cls \family default , resp. \begin_inset space ~ \end_inset -of the -Koma --Script family. +of the Koma-Script family. They are replacements for the standard document classes \family typewriter -article. -cls +article.cls \family default , \family typewriter -report. -cls +report.cls \family default , \family typewriter -book. -cls +book.cls \family default and \family typewriter -letter. -cls +letter.cls \family default , resp., and fit better to European typography conventions in a number of points. \end_layout \begin_layout Itemize -Standard character size is -11pt - in +Standard character size is 11pt in \emph on -article ( -koma --script) +article (koma-script) \emph default , \emph on -report ( -koma --script) +report (koma-script) \emph default , and \emph on -book ( -koma --script) +book (koma-script) \emph default -, and -12pt - in +, and 12pt in \emph on -letter ( -koma --script) +letter (koma-script) \emph default . \end_layout @@ -13384,9 +11755,7 @@ koma Headings, labels of the description environment, and a number of elements of the \emph on -letter ( -koma --script) +letter (koma-script) \emph default document class are set in a bold sans serif font. \begin_inset Foot @@ -13394,18 +11763,11 @@ status collapsed \begin_layout Plain Layout There is a big difference between the bold sans serif old cm fonts and new - -ec - fonts, especially in the appearance of headings. - In comparison, the -ec - bold sans serif fonts look a bit thin. - Here the -LaTeX - package + ec fonts, especially in the appearance of headings. + In comparison, the ec bold sans serif fonts look a bit thin. + Here the LaTeX package \family typewriter -cmsd -.sty by +cmsd.sty by \family default \shape smallcaps @@ -13419,9 +11781,7 @@ usual \begin_inset Quotes erd \end_inset - appearance when using the -ec - fonts. + appearance when using the ec fonts. \end_layout \end_inset @@ -13452,9 +11812,8 @@ Layout\SpecialChar \menuseparator Document \family default ). - A detailed German description of these options can be found in the -Koma --Script documentation + A detailed German description of these options can be found in the Koma-Script + documentation \emph on scrguide \emph default @@ -13462,9 +11821,8 @@ scrguide \end_layout \begin_layout Itemize -The main means in the -Koma --Script document classes to design the type area are the options +The main means in the Koma-Script document classes to design the type area + are the options \family sans BCOR \family default @@ -13486,9 +11844,7 @@ Settings \family default . A detailed German description of these and other type area options can - be found in the -Koma --Script documentation + be found in the Koma-Script documentation \emph on scrguide \emph default @@ -13496,23 +11852,15 @@ scrguide \end_layout \begin_layout Itemize -The -LaTeX - document classes of the -Koma --Script family define a number of additional commands. +The LaTeX document classes of the Koma-Script family define a number of + additional commands. Those part of it which makes sense in LyX is implemented in corresponding paragraph types. \end_layout \begin_layout Standard -A detailed German description of the -LaTeX - document classes of the -Koma --Script family can be found in the -Koma --Script documentation +A detailed German description of the LaTeX document classes of the Koma-Script + family can be found in the Koma-Script documentation \emph on scrguide \emph default @@ -13535,27 +11883,17 @@ screnggu \end_layout \begin_layout Subsection -article ( -koma --script), report ( -koma --script), and book ( -koma --script) +article (koma-script), report (koma-script), and book (koma-script) \end_layout \begin_layout Standard The document classes \emph on -article ( -koma --script) +article (koma-script) \emph default , \emph on -report ( -koma --script) +report (koma-script) \emph default , and \emph on @@ -13563,24 +11901,19 @@ book \emph default \emph on -( -koma --script) +(koma-script) \emph default are implemented in the layout files \family typewriter -scrartcl -.layout +scrartcl.layout \family default , \family typewriter -scrreprt -.layout +scrreprt.layout \family default , and \family typewriter -scrbook -.layout +scrbook.layout \family default , resp. They contain all the paragraph types of the corresponding standard document @@ -13616,9 +11949,7 @@ not \emph default part of \emph on -letter ( -koma --script) +letter (koma-script) \emph default . \end_layout @@ -13626,9 +11957,7 @@ koma \begin_layout Itemize \family sans -Addpart -, -Addchap +Addpart, Addchap \family default , \family sans @@ -13653,9 +11982,7 @@ Addchap \family default are not contained in \emph on -article ( -koma --script) +article (koma-script) \emph default . \end_layout @@ -13663,13 +11990,11 @@ koma \begin_layout Itemize \family sans -Addchap -* +Addchap* \family default , \family sans -Addsec -* +Addsec* \family default : behave exactly as \family sans @@ -13682,14 +12007,11 @@ Addsec , resp., additionally clearing running heads. \family sans -Addchap -* +Addchap* \family default is not contained in \emph on -article ( -koma --script) +article (koma-script) \emph default . \begin_inset Foot @@ -13700,21 +12022,15 @@ There is also an \family typewriter \backslash - -addpart -* +addpart* \family default command in \emph on -book ( -koma --script) +book (koma-script) \emph default and in \emph on -report ( -koma --script) +report (koma-script) \emph default , but since this is identical to \family sans @@ -13766,11 +12082,7 @@ captionabove captionbelow \family default for figures. - You need at least -Koma --Script version 2. -8q - to use this. + You need at least Koma-Script version 2.8q to use this. \end_layout \begin_layout Itemize @@ -13778,9 +12090,7 @@ Koma \family sans Dictum \family default -: can be used to set a -bonmot -, e. +: can be used to set a bonmot, e. \begin_inset space \thinspace{} \end_inset @@ -13800,20 +12110,14 @@ Title \family default ), you can insert the dictum's author there. Dictum and author are separated by a line. - You need at least -Koma --Script version 2. -8q - to use this. + You need at least Koma-Script version 2.8q to use this. \family sans Dictum \family default is not contained in \emph on -article ( -koma --script) +article (koma-script) \emph default . \end_layout @@ -13845,13 +12149,10 @@ ordinary status collapsed \begin_layout Plain Layout -The corresponding -LaTeX - commands must appear before the +The corresponding LaTeX commands must appear before the \family typewriter \backslash - maketitle \family default command. @@ -13913,9 +12214,7 @@ Author \family sans Date \family default -) for the -publishers' - name. +) for the publishers' name. \end_layout \begin_layout Itemize @@ -13925,22 +12224,16 @@ Dedication \family default : in \emph on -report ( -koma --script) +report (koma-script) \emph default and \emph on -book ( -koma --script) +book (koma-script) \emph default produces a centered paragraph on its own page behind the title page, or in \emph on -article ( -koma --script) +article (koma-script) \emph default produces a centered paragraph below the ordinary title ( \family sans @@ -13992,22 +12285,16 @@ Uppertitleback \family default : produces in a double-sided print in \emph on -report ( -koma --script) +report (koma-script) \emph default and \emph on -book ( -koma --script) +book (koma-script) \emph default a left-aligned paragraph at the top of the title page`s back or has no effect in a single-sided print or in \emph on -article ( -koma --script) +article (koma-script) \emph default . \end_layout @@ -14019,22 +12306,16 @@ Lowertitleback \family default : produces in a double-sided print in \emph on -report ( -koma --script) +report (koma-script) \emph default and \emph on -book ( -koma --script) +book (koma-script) \emph default a left-aligned paragraph at the bottom of the title page`s back or has no effect in a single-sided print or in \emph on -article ( -koma --script) +article (koma-script) \emph default . \end_layout @@ -14059,31 +12340,23 @@ dirty \begin_layout Standard The layout files for the document classes \emph on -article ( -koma --script) +article (koma-script) \emph default , \emph on -report ( -koma --script) +report (koma-script) \emph default , and \emph on -book ( -koma --script) +book (koma-script) \emph default do include the file \family typewriter -scrmacros -.inc +scrmacros.inc \family default . This is thought of as a place to define your own types. - Copy -scrmacros + Copy scrmacros \family typewriter .inc \family default @@ -14091,9 +12364,7 @@ scrmacros \end_layout \begin_layout Subsection -letter ( -koma --script) +letter (koma-script) \end_layout \begin_layout Standard @@ -14116,14 +12387,11 @@ begin{sloppypar} \noindent The document class \emph on -letter ( -koma --script) +letter (koma-script) \emph default is implemented in the layout file \family typewriter -scrlettr -.layout +scrlettr.layout \family default . It contains all the paragraph types of the corresponding standard document @@ -14187,11 +12455,7 @@ end{sloppypar} \begin_layout Standard The appearance of the letter produced by this document class can be controlled - by a number of -LaTeX - commands, which you can put in the -LaTeX - preamble. + by a number of LaTeX commands, which you can put in the LaTeX preamble. \begin_inset Foot status collapsed @@ -14206,104 +12470,67 @@ ordinary \begin_inset Quotes erd \end_inset - heading is produced by the following -LaTeX - commands in the preamble: + heading is produced by the following LaTeX commands in the preamble: \end_layout \begin_layout LyX-Code \backslash - -firsthead -{ +firsthead{ \backslash - -parbox -[b]{ +parbox[b]{ \backslash - -textwidth -} +textwidth} \end_layout \begin_layout LyX-Code { \backslash - -ignorespaces - +ignorespaces \backslash - fromname - \backslash \backslash \backslash - -ignorespaces - +ignorespaces \backslash - -fromaddress -}} +fromaddress}} \end_layout \begin_layout LyX-Code \backslash - -nexthead -{ +nexthead{ \backslash - -parbox -[b]{ +parbox[b]{ \backslash - -textwidth -} +textwidth} \end_layout \begin_layout LyX-Code { \backslash - -ignorespaces - +ignorespaces \backslash - -fromname - +fromname \backslash - -hfill - +hfill \backslash - -ignorespaces - +ignorespaces \backslash - pagename - \backslash \backslash - -thepage -}} +thepage}} \end_layout \end_inset - A detailed German description of such -LaTeX - commands can be found in the -Koma --Script documentation + A detailed German description of such LaTeX commands can be found in the + Koma-Script documentation \emph on scrguide \emph default @@ -14462,9 +12689,7 @@ Subject status open \begin_layout Plain Layout -It could be seen as a matter of -inconsequence -, that the types +It could be seen as a matter of inconsequence, that the types \family sans Letter \family default @@ -14599,13 +12824,11 @@ Address \family sans Telephone \family default -: sender's telephone number, in the standard behavior only sets the -LaTeX +: sender's telephone number, in the standard behavior only sets the LaTeX variable \family typewriter \backslash - telephonenum \family default . @@ -14792,13 +13015,10 @@ business letter types \family sans Place \family default - type however does not appear, but only the -LaTeX - variable + type however does not appear, but only the LaTeX variable \family typewriter \backslash - fromplace \family default is set. @@ -14853,9 +13073,7 @@ Invoice \end_layout \begin_layout Subsection -The new letter class: letter ( -koma --script v.2) +The new letter class: letter (koma-script v.2) \end_layout \begin_layout Standard @@ -14873,9 +13091,7 @@ Jürgen Spitzmüller \begin_layout Standard \noindent - -Koma --Script version 2.8 has introduced a new letter class +Koma-Script version 2.8 has introduced a new letter class \family typewriter scrlttr2 \family default @@ -14884,18 +13100,15 @@ scrlttr2 scrlettr \family default . - It has — on the -LaTeX - side — a completely new interface and is not compatible with the old class. + It has — on the LaTeX side — a completely new interface and is not compatible + with the old class. Therefore, LyX supports both, though it is recommended to use the new class. \end_layout \begin_layout Standard This class covers the same functionality as \emph on -letter ( -koma --script), +letter (koma-script), \emph default and a few more. The basic items are @@ -14962,34 +13175,25 @@ The biggest improvement is, though, that the letter's layout is configurable This can be done via the preamble or with a special style file (Letter Class Option, extension \family typewriter -*. -lco +*.lco \family default ), that will be read in as a class option. \begin_inset Foot status collapsed \begin_layout Plain Layout -The -KOMA - package comes with some default +The KOMA package comes with some default \family typewriter -*. -lco +*.lco \family default files. There is, for instance, a \family typewriter -DIN. -lco +DIN.lco \family default - file that follows -german - typesetting rules, or a + file that follows german typesetting rules, or a \family typewriter -KOMAold -. -lco +KOMAold.lco \family default that provides the default layout of the old \family typewriter @@ -15020,14 +13224,11 @@ Extra Options Have a look at the \emph on -koma -- -letter2 +koma-letter2 \emph default template that is included in LyX for examples. - A detailed description is to be found in the -Koma --Script documentation ( + A detailed description is to be found in the Koma-Script documentation + ( \emph on scrguide \emph default @@ -15039,9 +13240,8 @@ Problems \end_layout \begin_layout Standard -Visualizing the -Koma --Script document classes in LyX, the LyX internals cause some problems. +Visualizing the Koma-Script document classes in LyX, the LyX internals cause + some problems. \end_layout \begin_layout Itemize @@ -15051,9 +13251,7 @@ Chapter \family default type appears on a line of its own above the chapter heading instead of appearing in the same line ahead of it. - The cause for that is the LyX internal behavior for the -labeltype - + The cause for that is the LyX internal behavior for the labeltype \family sans Counter_Chapter \family default @@ -15077,9 +13275,7 @@ true \begin_inset Quotes erd \end_inset - -LaTeX - table of contents, but not in the LyX table of contents ( + LaTeX table of contents, but not in the LyX table of contents ( \family sans Document\SpecialChar \menuseparator Table @@ -15101,9 +13297,8 @@ The paragraphs in a letter \emph default document class appear in a skip separation mode, not indented. - This is the standard behavior, no special -LaTeX - commands are needed for that. + This is the standard behavior, no special LaTeX commands are needed for + that. But in the \family sans Document\SpecialChar \menuseparator @@ -15118,18 +13313,12 @@ Indent \family sans Skip \family default - value always has the effect that extra -LaTeX - commands are inserted in the document to produce the gap, which is not - what is wanted in this case. + value always has the effect that extra LaTeX commands are inserted in the + document to produce the gap, which is not what is wanted in this case. \end_layout \begin_layout Section - -Latex8 - ( -IEEE - Conference Papers) +Latex8 (IEEE Conference Papers) \end_layout \begin_layout Standard @@ -15143,10 +13332,8 @@ Introduction \end_layout \begin_layout Standard -Since this class is specifically for writing submissions to -IEEE - sponsored conferences I strongly recommend that you get a copy of their - Authors Kit. +Since this class is specifically for writing submissions to IEEE sponsored + conferences I strongly recommend that you get a copy of their Authors Kit. The \family sans latex.sty @@ -15262,15 +13449,11 @@ Memoir is a very powerful and constantly evolving class. \begin_layout Standard Peter Wilson, the developer of Memoir, is known as the author of lots of - useful packages in the -LaTeX - world. + useful packages in the LaTeX world. Most of them have been merged with Memoir. Therefore, it is much easier to layout the table of contents, appendices, chapter designs and such. - LyX, though, does not support all of these goodies -natively -. + LyX, though, does not support all of these goodies natively. Some of them might be added to forthcoming releases \begin_inset Foot status collapsed @@ -15293,8 +13476,7 @@ lyx-devel@lists.lyx.org \end_inset , lots will probably never, due to the limitations of LyX's framework. - Of course you can still use all features with the help of some native -LaTeX + Of course you can still use all features with the help of some native LaTeX commands (TeX code \begin_inset Foot status collapsed @@ -15330,9 +13512,8 @@ reference "sec:Inserting-TeX-Code" \end_inset ). - In this section, we can only list those features which are -natively - supported by LyX. + In this section, we can only list those features which are natively supported + by LyX. For detailed descriptions (and for the rest of features) we are recommending to have a look at the detailed manual of the Memoir class \begin_inset Foot @@ -15387,16 +13568,7 @@ Font \begin_inset space ~ \end_inset -sizes: Memoir has a broader range of font sizes: 9, -10 -, -11 -, -12 -, -14 -, -17 +sizes: Memoir has a broader range of font sizes: 9, 10, 11, 12, 14, 17 \end_layout \begin_layout Description @@ -15405,12 +13577,8 @@ Page \end_inset style: The fancy page style is not supported, due to a command clash between - Memoir and the -fancyhdr - package (they are both defining a command with the same name, which confuses - -LaTeX -). + Memoir and the fancyhdr package (they are both defining a command with + the same name, which confuses LaTeX). Instead, Memoir comes with a bunch of own page styles (see \family sans Layout\SpecialChar \menuseparator @@ -15427,7 +13595,6 @@ Style \family typewriter \backslash - chapterstyle \family default in the main text or in preamble (e. @@ -15442,18 +13609,14 @@ g. \family typewriter \backslash - -chapterstyle -{companion} +chapterstyle{companion} \family default ). \end_layout \begin_layout Description -Sectioning: -Sectionings - (chapter, section, subsection etc.) are coming with an optional argument - in the standard classes. +Sectioning: Sectionings (chapter, section, subsection etc.) are coming with + an optional argument in the standard classes. With this, you can specify an alternative version of the title for the table of contents and the headers (for instance, if the title is too long). In LyX, you can do this via @@ -15476,21 +13639,16 @@ Title \end_layout \begin_layout Description - -TOC -/LOT/ -LOF -: In the standard classes (and in many other classes), the table of contents, - the list of figures and the list of table start a new page automatically. +TOC/LOT/LOF: In the standard classes (and in many other classes), the table + of contents, the list of figures and the list of table start a new page + automatically. Memoir does not follow this route. You have to insert a page break yourself, if you want to have one. \end_layout \begin_layout Description - -Titlepage -: For some unknown reason, Memoir uses pagination on the title page (in - the standard classes, title pages are +Titlepage: For some unknown reason, Memoir uses pagination on the title + page (in the standard classes, title pages are \begin_inset Quotes eld \end_inset @@ -15506,16 +13664,12 @@ g. \begin_inset space \space{} \end_inset -without -pagina -). +without pagina). If you want an empty title page, type \family typewriter \backslash - -aliaspagestyle -{title}{empty} +aliaspagestyle{title}{empty} \family default in the preamble. \end_layout @@ -15550,14 +13704,8 @@ real \end_layout \begin_layout Description - -Oldfontcommands -: By default, Memoir does not allow the use of the deprecated font commands, - which have been used in the old -LaTeX - version 2. -09 - (e. +Oldfontcommands: By default, Memoir does not allow the use of the deprecated + font commands, which have been used in the old LaTeX version 2.09 (e. \begin_inset space \thinspace{} \end_inset @@ -15578,23 +13726,15 @@ rm it \family default ). - It produces an error and stops -LaTeX - whenever such a command appears. + It produces an error and stops LaTeX whenever such a command appears. The class option \emph on oldfontcommands \emph default - -reallows - the commands and spits out warnings instead (which does at least not stop - -LaTeX -). - Since a lot of packages and particularly -BibTeX - style files are still using those commands, we have decided to use this - option by default. + reallows the commands and spits out warnings instead (which does at least + not stop LaTeX). + Since a lot of packages and particularly BibTeX style files are still using + those commands, we have decided to use this option by default. \end_layout \begin_layout Subsection @@ -15650,10 +13790,9 @@ Abstract: You may wonder why an abstract is an extra feature. \end_layout \begin_layout Description - -Chapterprecis -: You may know this from belletristic: The contents of a chapter is shortly - described below the title and also in the table of contents (e. +Chapterprecis: You may know this from belletristic: The contents of a chapter + is shortly described below the title and also in the table of contents + (e. \begin_inset space \thinspace{} \end_inset @@ -15663,14 +13802,10 @@ g. \emph on -Our hero arrives in -Troia -; he loses some friends; he finds others +Our hero arrives in Troia; he loses some friends; he finds others \emph default ). - -Chapterprecis - does exactly this. + Chapterprecis does exactly this. It is therefore only sensible below a chapter. \end_layout @@ -15697,36 +13832,23 @@ Epigraph: An epigraph is a smart slogan or motto at the beginning of a chapter. \end_layout \begin_layout Description - -Poemtitle -: Memoir has lots of possibilities to typeset poetry (up to very complex - figurative poems). +Poemtitle: Memoir has lots of possibilities to typeset poetry (up to very + complex figurative poems). LyX can only support a few of them. - One is -poemtitle -, which is a centered title for poems, which will also be added to the table - of contents (verse is the standard environment for poems. + One is poemtitle, which is a centered title for poems, which will also + be added to the table of contents (verse is the standard environment for + poems. Memoir has some enhanced versions of verse, but you need to use TeX code, because they have to be nested inside regular verse environments, which is not possible with LyX). \end_layout \begin_layout Description - -Poemtitle -*: Same as -poemtitle -, but it adds no entry to the table of contents. +Poemtitle*: Same as poemtitle, but it adds no entry to the table of contents. \end_layout \begin_layout Section -Article ( -mwart -), book ( -mwbk -) and report ( -mwrep -) +Article (mwart), book (mwbk) and report (mwrep) \begin_inset OptArg status collapsed @@ -15746,23 +13868,17 @@ mw \begin_layout Standard by \noun on -Tomasz - -Luczak +Tomasz Luczak \end_layout \begin_layout Standard The LyX document classes \emph on -article ( -mwart -) +article (mwart) \emph default , \emph on -report ( -mwrep -) +report (mwrep) \emph default and \emph on @@ -15770,45 +13886,32 @@ book \emph default \emph on -( -mwbk -) +(mwbk) \emph default - correspond to the -LaTeX - document classes + correspond to the LaTeX document classes \family typewriter -mwart -. -cls +mwart.cls \family default , \family typewriter -mwrep -. -cls +mwrep.cls \family default and \family typewriter -mwbk -. -cls +mwbk.cls \family default , resp. They are replacements for the standard document classes \family typewriter -article. -cls +article.cls \family default , \family typewriter -report. -cls +report.cls \family default and \family typewriter -book. -cls +book.cls \family default , resp., and fit better to Polish typography conventions in a number of points. @@ -15840,35 +13943,27 @@ Additional page styles: \begin_deeper \begin_layout Description - -uheadings - header with separated lines, +uheadings header with separated lines, \end_layout \begin_layout Description - -myheadings - custom header, contents headers via commands: +myheadings custom header, contents headers via commands: \family typewriter \backslash - markright \family default and \family typewriter \backslash - markboth \family default , \end_layout \begin_layout Description - -myuheadings - custom header with separated lines, +myuheadings custom header with separated lines, \end_layout \begin_layout Description @@ -15882,35 +13977,23 @@ Options \begin_deeper \begin_layout Description - -rmheadings - serif titles — default, +rmheadings serif titles — default, \end_layout \begin_layout Description - -sfheadings - -sansserif - titles, +sfheadings sansserif titles, \end_layout \begin_layout Description - -authortitle - on title page first placed is author next title — default, +authortitle on title page first placed is author next title — default, \end_layout \begin_layout Description - -titleauthor - on title page first placed is title next author, +titleauthor on title page first placed is title next author, \end_layout \begin_layout Description - -withmarginpar - reserve place on page for margins. +withmarginpar reserve place on page for margins. \end_layout \end_deeper @@ -15933,16 +14016,13 @@ article \end_layout \begin_layout Section - RevTeX4 \end_layout \begin_layout Standard by \noun on -Amir - -Karger +Amir Karger \end_layout \begin_layout Standard @@ -15957,25 +14037,16 @@ Karger The \family sans Revtex - \begin_inset space ~ \end_inset 4 \family default - -textclass - works with the American Physical -Sociey's - -RevTeX - 4.0 (the + textclass works with the American Physical Sociey's RevTeX 4.0 (the \begin_inset Formula $\beta$ \end_inset - release of May, -1999 -) class. + release of May, 1999) class. \end_layout \begin_layout Standard @@ -15983,38 +14054,20 @@ LyX has a \family sans Revtex \family default - -textclass -, which works with -RevTeX - 3.1. - However, -v3 -.1 is basically obsolete, as it works with -LaTeX - 2. -09 -. + textclass, which works with RevTeX 3.1. + However, v3.1 is basically obsolete, as it works with LaTeX 2.09. That means that it doesn't interact very well with LyX, which requires - -LaTeX2e -, although it has been kludged to work. - Since -RevTeX - 4.0 has been designed to work much more cleanly with -LaTeX2e -, LyX with the + LaTeX2e, although it has been kludged to work. + Since RevTeX 4.0 has been designed to work much more cleanly with LaTeX2e, + LyX with the \family sans RevTeX - \begin_inset space ~ \end_inset 4 \family default - -textclass - should also be pretty easy to use. + textclass should also be pretty easy to use. \end_layout \begin_layout Standard @@ -16022,10 +14075,7 @@ These documents are supposed to be used in \emph on addition \emph default - to the -RevTeX - 4.0 documents, so we don't describe any of the special -RevTeX + to the RevTeX 4.0 documents, so we don't describe any of the special RevTeX macros, and assume you'll know what to put in the preamble if necessary. \end_layout @@ -16034,14 +14084,9 @@ Installation \end_layout \begin_layout Standard -All you need to do is install -RevTeX - 4, as described in the package's -README +All you need to do is install RevTeX 4, as described in the package's README file. - The package can be found at The -RevTeX - 4 Web Site + The package can be found at The RevTeX 4 Web Site \begin_inset Flex URL status collapsed @@ -16053,14 +14098,9 @@ http://publish.aps.org/revtex4/ \end_inset . - Install it somewhere that -LaTeX - can see it. - Test it by trying to -LaTeX - a short -RevTeX - 4 document in some random directory (i. + Install it somewhere that LaTeX can see it. + Test it by trying to LaTeX a short RevTeX 4 document in some random directory + (i. \begin_inset space \thinspace{} \end_inset @@ -16069,24 +14109,18 @@ g. \end_inset not the directory where you installed the class file.) Then, if you reconfigure - LyX, it will find the class file and let you use the -RevTeX4 - -textclass -. + LyX, it will find the class file and let you use the RevTeX4 textclass. \end_layout \begin_layout Standard -Probably the easiest way to get started is either to import a -RevTeX - 4 document using +Probably the easiest way to get started is either to import a RevTeX 4 document + using \family typewriter tex2lyx \family default , or to use the \family sans Revtex - \begin_inset space ~ \end_inset @@ -16104,16 +14138,13 @@ Optional arguments to \family typewriter \backslash - documentclass \family default , like \begin_inset Quotes eld \end_inset - preprint - \begin_inset Quotes erd \end_inset @@ -16121,9 +14152,7 @@ preprint \begin_inset Quotes eld \end_inset - aps - \begin_inset Quotes erd \end_inset @@ -16148,9 +14177,7 @@ Document Layout \family default dialog, as usual. - Remember that in -RevTeX -, at least one optional argument is required! + Remember that in RevTeX, at least one optional argument is required! \end_layout \begin_layout Standard @@ -16167,7 +14194,6 @@ draft goes in the \family sans LaTeX - \begin_inset space ~ \end_inset @@ -16181,9 +14207,7 @@ Layouts \end_layout \begin_layout Standard -The layouts basically correspond to the commands in -RevTeX4 -.0. +The layouts basically correspond to the commands in RevTeX4.0. For example, the Email layout corresponds to \family typewriter @@ -16191,9 +14215,7 @@ RevTeX4 email{} \family default . - Note that (at least as of -RevTeX - 4.0 Beta), the + Note that (at least as of RevTeX 4.0 Beta), the \family sans Address \family default @@ -16235,15 +14257,12 @@ Important Notes \end_layout \begin_layout Standard -There are a couple of important unique aspects of -RevTeX - 4 which might cause bugs that will be even more confusing in LyX. +There are a couple of important unique aspects of RevTeX 4 which might cause + bugs that will be even more confusing in LyX. \end_layout \begin_layout Standard -In -RevTeX -, the +In RevTeX, the \family typewriter \backslash @@ -16270,9 +14289,7 @@ not Author \family default layout, or weird things may happen. - See the -RevTeX - 4 documentation for more details. + See the RevTeX 4 documentation for more details. \end_layout \begin_layout Standard @@ -16321,9 +14338,7 @@ Thanks \family sans Address \family default -, the -LaTeX - won't compile. +, the LaTeX won't compile. \end_layout \begin_layout Subsection @@ -16335,13 +14350,9 @@ The main problem with this layout is that you can't use the optional arguments to layouts like Email and Title. (The problem is not unique to this layout; you can't use optional arguments to the Section layouts either.) This means that after you export that file - to -LaTeX - (which you'll need to do eventually to send it in to -APS -), you'll need to edit the -LaTeX - file with a text editor to add the optional arguments to set, e. + to LaTeX (which you'll need to do eventually to send it in to APS), you'll + need to edit the LaTeX file with a text editor to add the optional arguments + to set, e. \begin_inset space \thinspace{} \end_inset @@ -16354,14 +14365,12 @@ the running title for the page headers. \family typewriter \backslash - altaffiliation \family default (and the equivalent \family typewriter \backslash - altaddress \family default ) useless, so the corresponding layouts don't exist, and will have to be @@ -16372,9 +14381,7 @@ status collapsed \begin_layout Plain Layout \emph on -Note from -JMarc -: +Note from JMarc: \emph default actually, LyX 1.3.0 supports some forms of optional arguments, but this layout has not been updated yet to take advantage of it. @@ -16405,9 +14412,7 @@ Description \begin_layout Standard These are the layout files for some of the journal formats used by Springer - -Verlag - and listed on + Verlag and listed on \begin_inset Flex URL status collapsed @@ -16418,14 +14423,12 @@ http://www.springer.de/author/tex/help-journals.html \end_inset -, where you should also go to fetch the class files (yes, these are -LaTeX2e +, where you should also go to fetch the class files (yes, these are LaTeX2e now!). It is a modular system: the things common to all journals are implemented in \family typewriter -svjour -.inc +svjour.inc \family default , which journal-specific layout files (such as, e. \begin_inset space \thinspace{} @@ -16437,8 +14440,7 @@ g. \family typewriter -svjog -.layout +svjog.layout \family default for Journal of Geodesy) can include. \end_layout @@ -16449,16 +14451,13 @@ This means that implementing support for any other Springer journal on this \family typewriter sv \family default -< -myjournal -> + \family typewriter .layout \family default file following the outline given in \family typewriter -svjog -.layout +svjog.layout \family default . @@ -16476,11 +14475,7 @@ svjog \family default come with the standard LyX distribution. Install the relevant class file (downloaded from Springer) in a proper - directory, reconfigure -LaTeX - (in the -teTeX - case by running + directory, reconfigure LaTeX (in the teTeX case by running \family typewriter texhash \family default @@ -16508,12 +14503,8 @@ Theorem \begin_layout Standard \family sans -Headnote, Dedication, Subtitle, Running_ -LaTeX -_Title, Author_Running, Institute, Mail, Offprints, Keywords, -Acknowledgements -, -Acknowledgement +Headnote, Dedication, Subtitle, Running_LaTeX_Title, Author_Running, Institute, + Mail, Offprints, Keywords, Acknowledgements, Acknowledgement \family default . See the Springer class file documentation for details. @@ -16530,8 +14521,7 @@ Journal of Geodesy \emph default : \family typewriter -svjog -.layout +svjog.layout \family default — Martin Vermeer \end_layout @@ -16543,11 +14533,9 @@ Probability Theory and Related Fields \emph default : \family typewriter -svprobth -.layout +svprobth.layout \family default - — Jean-Marc -Lasgouttes + — Jean-Marc Lasgouttes \end_layout \begin_layout Standard @@ -16561,22 +14549,17 @@ Credits \begin_layout Standard These files are partly based on the older \family typewriter -ejour2 -.layout +ejour2.layout \family default -, which was again based on a tinkered-with version of an old -LaTeX - 2. -09 - style file from Springer. +, which was again based on a tinkered-with version of an old LaTeX 2.09 style + file from Springer. All this, and the \family typewriter ejour2 \family default layout, are now defunct. - Jean-Marc -Lasgouttes - helped out big in making me find my way around the LyX layout file mechanism. + Jean-Marc Lasgouttes helped out big in making me find my way around the + LyX layout file mechanism. \end_layout \begin_layout Subsection @@ -16585,9 +14568,7 @@ Bugs \begin_layout Standard Probably. - But probably less than in the old hacked- -LaTeX - + But probably less than in the old hacked-LaTeX \family typewriter ejour2 \family default @@ -16687,9 +14668,7 @@ If you're looking for the documentation for \family sans -slides ( -FoilTeX -) +slides (FoilTeX) \family default \begin_inset Quotes erd @@ -16717,9 +14696,7 @@ foils \family sans -slides ( -FoilTeX -) +slides (FoilTeX) \family default \begin_inset Quotes erd @@ -16745,16 +14722,13 @@ or so I've been told repeatedly by its advocates. \end_layout \begin_layout Standard -This class is the -LaTeX2e - improvement of the old +This class is the LaTeX2e improvement of the old \noun on SliTeX \noun default package. - Every -LaTeX2e - distribution includes this class [which I'll just refer to as + Every LaTeX2e distribution includes this class [which I'll just refer to + as \begin_inset Quotes eld \end_inset @@ -16925,8 +14899,7 @@ You can also use the template file \family typewriter -slides. -lyx +slides.lyx \family default \begin_inset Quotes erd @@ -17142,9 +15115,7 @@ feature \begin_inset Quotes eld \end_inset - -LaTeX - magic. +LaTeX magic. \begin_inset Quotes erd \end_inset @@ -17164,9 +15135,7 @@ name "sec:slideQuirk" \begin_layout Standard All five of the new paragraph environments are somewhat quirky due to inherent - -limitiations - in the current version of LyX. + limitiations in the current version of LyX. As I just mentioned, LyX forbids environments that begin with another environme nt. To get around this, the @@ -17255,9 +15224,7 @@ InvisibleText \family sans VisibleText \family default -, is a rather long- -ish - label. +, is a rather long-ish label. The text following this label — ordinarily the contents of the paragraph environment — is utterly irrelevant for \family sans @@ -17290,9 +15257,7 @@ While you don't \emph on have \emph default - to put any text after the rather long- -ish - label, you might want to. + to put any text after the rather long-ish label, you might want to. This could be a short description of the contents of the \family sans Slide @@ -17461,9 +15426,7 @@ ASCII line, \begin_inset Quotes eld \end_inset - -NewSlide -: +NewSlide: \begin_inset Quotes erd \end_inset @@ -17488,9 +15451,7 @@ Paragraph Layout \family sans Overlay \family default - you've made to accompany the -oversized - + you've made to accompany the oversized \family sans Slide \family default @@ -17523,9 +15484,7 @@ ASCII line \begin_inset Quotes eld \end_inset - -NewOverlay -: +NewOverlay: \begin_inset Quotes erd \end_inset @@ -17533,9 +15492,7 @@ NewOverlay \begin_inset Quotes eld \end_inset - -NewNote -: +NewNote: \begin_inset Quotes erd \end_inset @@ -17655,9 +15612,7 @@ Slide status collapsed \begin_layout Plain Layout -Presumably, -mutliple - +Presumably, mutliple \family sans Overlay \family default @@ -17968,9 +15923,7 @@ InvisibleText \family sans VisibleText \family default - and vice- -versa -. + and vice-versa. \end_layout \begin_layout Standard @@ -17989,11 +15942,7 @@ slides \family default class: you can't make text in the middle of a paragraph invisible, nor make text in the middle of an invisible paragraph visible again. - To accomplish this feat, you'll need to use some -inlined - -LaTeX - codes. + To accomplish this feat, you'll need to use some inlined LaTeX codes. \begin_inset Foot status collapsed @@ -18229,9 +16178,7 @@ native SliTeX \noun default feature. - So, you'll have to resort to using the -LaTeX - codes. + So, you'll have to resort to using the LaTeX codes. \end_layout \begin_layout Standard @@ -18265,9 +16212,7 @@ reference "sec:slidesetup" Note \family default you generate. - To set what appears in the time marker, you use the -LaTeX - commands + To set what appears in the time marker, you use the LaTeX commands \begin_inset Quotes eld \end_inset @@ -18275,9 +16220,7 @@ LaTeX \family typewriter \backslash - -settime -{} +settime{} \family default \begin_inset Quotes erd @@ -18291,9 +16234,7 @@ settime \family typewriter \backslash - -addtime -{} +addtime{} \family default \begin_inset Quotes erd @@ -18309,9 +16250,7 @@ addtime \family typewriter \backslash - -settime -{} +settime{} \family default \begin_inset Quotes erd @@ -18326,9 +16265,7 @@ settime \family typewriter \backslash - -addtime -{} +addtime{} \family default \begin_inset Quotes erd @@ -18379,9 +16316,8 @@ Slide \end_layout \begin_layout Standard -Luckily, there are two -LaTeX - commands that allow you to select what to print out. +Luckily, there are two LaTeX commands that allow you to select what to print + out. Both must be placed into the preamble of your document. The command \begin_inset Quotes eld @@ -18391,9 +16327,7 @@ LaTeX \family typewriter \backslash - -onlyslides -{ +onlyslides{ \backslash slides} \family default @@ -18418,9 +16352,7 @@ s. \family typewriter \backslash - -onlynotes -{ +onlynotes{ \backslash notes} \family default @@ -18436,12 +16368,9 @@ s. I'd advise placing both commands in the preamble and initially comment both out. You can then preview your entire presentation as you write. - When you're done writing, you can then -uncomment - one of the two to select what you want to print. - I like to -uncomment - + When you're done writing, you can then uncomment one of the two to select + what you want to print. + I like to uncomment \begin_inset Quotes eld \end_inset @@ -18449,9 +16378,7 @@ uncomment \family typewriter \backslash - -onlyslides -{ +onlyslides{ \backslash slides} \family default @@ -18471,9 +16398,7 @@ slides} \begin_inset Quotes erd \end_inset - in its name, comment it back out, then -uncomment - + in its name, comment it back out, then uncomment \begin_inset Quotes eld \end_inset @@ -18481,9 +16406,7 @@ uncomment \family typewriter \backslash - -onlynotes -{ +onlynotes{ \backslash notes} \family default @@ -18497,8 +16420,7 @@ notes} \family typewriter -*-notes. -ps +*-notes.ps \family default \begin_inset Quotes erd @@ -18518,9 +16440,7 @@ You can also provide other arguments to the \family typewriter \backslash - -onlyslides -{} +onlyslides{} \family default \begin_inset Quotes erd @@ -18534,18 +16454,14 @@ onlyslides \family typewriter \backslash - -onlynotes -{} +onlynotes{} \family default \begin_inset Quotes erd \end_inset commands. - See a good -LaTeX - book for details. + See a good LaTeX book for details. \end_layout \begin_layout Subsection @@ -18563,8 +16479,7 @@ I have also provided a template file, \family typewriter -slides. -lyx +slides.lyx \family default \begin_inset Quotes erd @@ -18630,9 +16545,7 @@ VisibleText \end_layout \begin_layout LyX-Code -% -Uncomment - to print out only slides and overlays +% Uncomment to print out only slides and overlays \end_layout \begin_layout LyX-Code @@ -18642,9 +16555,7 @@ Uncomment \begin_layout LyX-Code % \backslash - -onlyslides -{ +onlyslides{ \backslash slides} \begin_inset Newline newline @@ -18654,9 +16565,7 @@ slides} \end_layout \begin_layout LyX-Code -% -Uncomment - to print out only notes +% Uncomment to print out only notes \end_layout \begin_layout LyX-Code @@ -18666,17 +16575,13 @@ Uncomment \begin_layout LyX-Code % \backslash - -onlynotes -{ +onlynotes{ \backslash notes} \end_layout \begin_layout Standard -One final thing: I created this class to support the -LaTeX2e - +One final thing: I created this class to support the LaTeX2e \begin_inset Quotes eld \end_inset @@ -18688,15 +16593,12 @@ SliTeX \begin_inset Quotes erd \end_inset - class, one of the built-in -LaTeX2e - classes. + class, one of the built-in LaTeX2e classes. Neither I nor the rest of the LyX Team endorse or oppose the use of this built-in slide class. It's here if you want it or need it. - There exist other -LaTeX2e - classes for creating presentations, such as the + There exist other LaTeX2e classes for creating presentations, such as the + \family sans Foils \family default @@ -18750,9 +16652,7 @@ Checking TeX \begin_layout Standard by \noun on -Asger - -Alstrup +Asger Alstrup \end_layout \begin_layout Subsection @@ -18773,11 +16673,7 @@ status collapsed \family typewriter chktex \family default - is not yet available when you are using the -LaTeX - distribution -MiKTeX -. + is not yet available when you are using the LaTeX distribution MiKTeX. \end_layout \end_inset @@ -18799,9 +16695,7 @@ TeX \family typewriter chktex \family default - it from -CTAN -, + it from CTAN, \begin_inset CommandInset href LatexCommand href target "http://www.ctan.org/tex-archive/help/Catalogue/entries/chktex.html" @@ -18825,32 +16719,25 @@ Jens T. \begin_inset space ~ \end_inset -Berger -Thielemann +Berger Thielemann \end_layout \end_inset - in frustration because some constructs in -LaTeX - are sometimes non-intuitive, and easy to forget. - The program runs over your -LaTeX - file, checks the integrity of the file, and flags some common errors. + in frustration because some constructs in LaTeX are sometimes non-intuitive, + and easy to forget. + The program runs over your LaTeX file, checks the integrity of the file, + and flags some common errors. In other technical words, it is \family typewriter lint \family default - for -LaTeX -. + for LaTeX. \end_layout \begin_layout Standard Well, what is a syntax checker doing in LyX which is supposed to produce - correct -LaTeX - anyways? The answer is simple: Just as + correct LaTeX anyways? The answer is simple: Just as \family typewriter Lint \family default @@ -18982,9 +16869,7 @@ x \begin_inset Newline newline \end_inset - -2x2 - looks cheap compared to +2x2 looks cheap compared to \begin_inset Formula $2\times2$ \end_inset @@ -19020,9 +16905,7 @@ Check TeX \family default . - This will make LyX generate a -LaTeX - file of your document, start + This will make LyX generate a LaTeX file of your document, start \family sans ChkTeX \family default @@ -19142,9 +17025,8 @@ is ChkTeX \family default in LyX this way. - Since LyX has to generate a somewhat special -LaTeX - file to be able to match the line numbers from the + Since LyX has to generate a somewhat special LaTeX file to be able to match + the line numbers from the \family sans ChkTeX \family default @@ -19164,9 +17046,7 @@ View \begin_inset space ~ \end_inset - LaTeX - \begin_inset space ~ \end_inset @@ -19218,13 +17098,10 @@ chktexrc \end_layout \begin_layout Itemize -Export your document as a raw -LaTeX - file using +Export your document as a raw LaTeX file using \family sans File\SpecialChar \menuseparator Export\SpecialChar \menuseparator - LaTeX \family default and run @@ -19255,23 +17132,7 @@ Preferences The emphasized entries are disabled by default, because the default is " \family typewriter -chktex - - -n1 - - -n3 - - -n6 - - -n9 - - -n22 - - -n25 - - -n30 - - -n38 +chktex -n1 -n3 -n6 -n9 -n22 -n25 -n30 -n38 \family default ". \end_layout @@ -19560,9 +17421,7 @@ No match found for \begin_layout Enumerate \size small -Math mode still on at end of -LaTeX - file. +Math mode still on at end of LaTeX file. \end_layout \begin_layout Enumerate @@ -19636,15 +17495,11 @@ You should use " \family typewriter ' \family default -" (ASCII -39 -) instead of " +" (ASCII 39) instead of " \family typewriter ´ \family default -" (ASCII -180 -). +" (ASCII 180). \end_layout \begin_layout Enumerate @@ -19672,7 +17527,6 @@ Comment displayed. Either \family typewriter '' - \backslash ,' \family default @@ -19680,8 +17534,7 @@ Either \family typewriter ' \backslash -, -'' +,'' \family default will look better. \end_layout @@ -19720,9 +17573,7 @@ You ought to remove spaces in front of punctuation. \begin_layout Enumerate \size small -Could not execute -LaTeX - command. +Could not execute LaTeX command. \end_layout \begin_layout Enumerate @@ -19855,9 +17706,7 @@ You should put punctuation outside inner/inside display math mode. \begin_layout Enumerate \size small -You ought to not use primitive TeX in -LaTeX - code. +You ought to not use primitive TeX in LaTeX code. \end_layout \begin_layout Enumerate @@ -19925,16 +17774,11 @@ Version Control in LyX \begin_layout Standard by \noun on - Lars -Gullik - -Bjønnes -, + Lars Gullik Bjønnes, \noun default updated by \noun on -Pavel -Sanda +Pavel Sanda \end_layout \begin_layout Subsection @@ -19946,16 +17790,9 @@ A friend of mine wanted to try LyX for a group project. When he didn't find support for version control or file locking, he dropped it. This angered me a bit, so I thought that I should at least make support - for -RCS - (with the possibility of -CVS - and/or -SCCS - as a future improvement.) This has now been done. - LyX now supports some of the most basic -RCS - commands. + for RCS (with the possibility of CVS and/or SCCS as a future improvement.) + This has now been done. + LyX now supports some of the most basic RCS commands. If you need to something a bit more sophisticated you will have to do that manually in an xterm. \end_layout @@ -19966,26 +17803,18 @@ Before you begin to use the version control features in LyX, you should \begin_inset Quotes eld \end_inset - rcsintro - \begin_inset Quotes erd \end_inset (a man file, read it with \family typewriter -man -rcsintro +man rcsintro \family default ). - This file describes all the basic features of -RCS -. - You should especially notice the comment about a -RCS - directory, and the notion of a master -RCS - file (the file ending in + This file describes all the basic features of RCS. + You should especially notice the comment about a RCS directory, and the + notion of a master RCS file (the file ending in \family typewriter ,v \family default @@ -19993,46 +17822,28 @@ RCS \end_layout \begin_layout Standard -Later basic -CVS -/ -SVN - support was added. - You should be familiar with -CVS -/ -SVN - usage before start using it under LyX. +Later basic CVS/SVN support was added. + You should be familiar with CVS/SVN usage before start using it under LyX. Most of the log messages are not currently displayed after operations - you can check them in terminal window if unsure. \end_layout \begin_layout Standard -The implementation in LyX assumes a recent version of the GNU -RCS - or -CVS -/ -SVN +The implementation in LyX assumes a recent version of the GNU RCS or CVS/SVN package—no guarantees are made for older versions. \end_layout \begin_layout Standard -For introducing your own external commands consult -vc --command in the manual of LyX functions. +For introducing your own external commands consult vc-command in the manual + of LyX functions. \end_layout \begin_layout Subsection - -RCS - commands in LyX +RCS commands in LyX \end_layout \begin_layout Standard -The following sections describe the -RCS - commands supported by LyX. +The following sections describe the RCS commands supported by LyX. You can find them in the \family sans File\SpecialChar \menuseparator @@ -20042,12 +17853,8 @@ Version Control \family default - -submenu -. - LyX was tested against -RCS - 5.7. + submenu. + LyX was tested against RCS 5.7. \end_layout \begin_layout Subsubsection @@ -20068,12 +17875,10 @@ Register \end_layout \begin_layout Standard -This command registers your document with -RCS - (unless you are under the directory managed by -CVS -)\SpecialChar \@. - You are asked interactively to supply an initial description of the document. +This command registers your document with RCS (unless you are under the + directory managed by CVS)\SpecialChar \@. + You are asked interactively to supply an initial + description of the document. The document is now set in Read-Only mode and you have to \family sans Check @@ -20095,33 +17900,23 @@ Edit \begin_inset Quotes eld \end_inset -[ -RCS -: ] +[RCS: ] \begin_inset Quotes erd \end_inset - item tagged to the -filename - in the -minibuffer -. + item tagged to the filename in the minibuffer. \end_layout \begin_layout Standard - -RCS - command that is run: +RCS command that is run: \family typewriter -ci - -q -u -i -t-"" +ci -q -u -i -t-"" \end_layout \begin_layout Standard Read \family typewriter -man -ci +man ci \family default to understand the switches. @@ -20137,19 +17932,15 @@ Check In Changes When you are finished editing a file, you check in your changes. When you do this, you are asked for a description of the changes. This is stored in the history log. - The version number is bumped, your changes are applied to the master -RCS + The version number is bumped, your changes are applied to the master RCS file, the document is unlocked and set to Read-Only mode. \end_layout \begin_layout Standard - -RCS - command: +RCS command: \family typewriter -ci - -q -u -m"" +ci -q -u -m"" \end_layout \begin_layout Subsubsection @@ -20168,9 +17959,7 @@ By doing this you lock the document so that only you can edit it. \end_layout \begin_layout Standard - -RCS - command: +RCS command: \family typewriter co -q -l \end_layout @@ -20188,9 +17977,7 @@ This will discard all changes made to the document since the last check \end_layout \begin_layout Standard - -RCS - command: +RCS command: \family typewriter co -f -u \end_layout @@ -20198,26 +17985,20 @@ co -f -u \begin_layout Subsubsection \family sans -Undo Last -Checkin +Undo Last Checkin \end_layout \begin_layout Standard This makes as if the last check in never happened. No changes are made to the document loaded into LyX, but the last version - is removed from the master -RCS - file. + is removed from the master RCS file. \end_layout \begin_layout Standard - -RCS - command: +RCS command: \family typewriter -rcs - -o +rcs -o \end_layout \begin_layout Subsubsection @@ -20227,33 +18008,25 @@ Show History \end_layout \begin_layout Standard -This show the complete history of the -RCS - document. +This show the complete history of the RCS document. The output of \family typewriter -rlog - +rlog \family default is shown in a browser. See \family typewriter -man -rlog +man rlog \family default for more info. \end_layout \begin_layout Subsection - -CVS - commands in LyX +CVS commands in LyX \end_layout \begin_layout Standard - -CVS - is now partially supported by LyX. +CVS is now partially supported by LyX. You can find the commands in the \family sans File\SpecialChar \menuseparator @@ -20263,9 +18036,7 @@ Version Control \family default - -submenu -. + submenu. \end_layout \begin_layout Subsubsection @@ -20289,15 +18060,10 @@ egister \end_layout \begin_layout Standard -This command registers in -CVS - your document ONLY in case you have already the documents directory under - -CVS - control (in particular +This command registers in CVS your document ONLY in case you have already + the documents directory under CVS control (in particular \family typewriter -CVS -/Entries +CVS/Entries \family default file exists). This means you have to checkout the archive by yourself. @@ -20307,18 +18073,13 @@ CVS \begin_layout Standard Then you are asked interactively to supply an initial description of the document. - Don't forget that registered file is not yet -commited -. + Don't forget that registered file is not yet commited. \end_layout \begin_layout Standard - -CVS - command that is run: +CVS command that is run: \family typewriter -cvs - -q add -m +cvs -q add -m \begin_inset Quotes erd \end_inset @@ -20336,8 +18097,7 @@ cvs \begin_layout Standard Read \family typewriter -man -svn +man svn \family default to understand the switches. @@ -20352,18 +18112,13 @@ Check In Changes \begin_layout Standard When you are finished editing a file, you commit your changes. When you do this, you are asked for a description of the changes. - After that changes are -commited -. + After that changes are commited. \end_layout \begin_layout Standard - -CVS - command: +CVS command: \family typewriter -cvs - -q commit -m"" "" +cvs -q commit -m"" "" \end_layout \begin_layout Subsubsection @@ -20376,18 +18131,13 @@ Revert To Repository Version This will discard all changes made to the document since the last check in. You get a warning before changes are discarded. - Firstly the file is deleted, secondly -CVS - update command is run. + Firstly the file is deleted, secondly CVS update command is run. \end_layout \begin_layout Standard - -CVS - command: +CVS command: \family typewriter -cvs - update +cvs update \begin_inset Quotes eld \end_inset @@ -20405,13 +18155,10 @@ Show History \end_layout \begin_layout Standard -This show the complete history of the -CVS - document. +This show the complete history of the CVS document. The output of \family typewriter -cvs - log +cvs log \begin_inset Quotes eld \end_inset @@ -20425,15 +18172,11 @@ cvs \end_layout \begin_layout Subsection - -SVN - commands in LyX +SVN commands in LyX \end_layout \begin_layout Standard - -SVN - is now partially supported by LyX. +SVN is now partially supported by LyX. You can find the commands in the \family sans File\SpecialChar \menuseparator @@ -20443,14 +18186,10 @@ Version Control \family default - -submenu -. + submenu. Please note that if you use password protected access to repository via ssh, you will be asked in terminal window. - LyX was tested against -SVN - 1.4 and 1.5. + LyX was tested against SVN 1.4 and 1.5. \end_layout \begin_layout Subsubsection @@ -20474,16 +18213,10 @@ egister \end_layout \begin_layout Standard -This command registers in -SVN - your document ONLY in case you have already the documents directory under - -SVN - control (in particular +This command registers in SVN your document ONLY in case you have already + the documents directory under SVN control (in particular \family typewriter -. -svn -/entries +.svn/entries \family default file exists). This means you have to checkout the archive by yourself. @@ -20493,18 +18226,13 @@ svn \begin_layout Standard Then you are asked interactively to supply an initial description of the document. - Don't forget that registered file is not yet -commited -. + Don't forget that registered file is not yet commited. \end_layout \begin_layout Standard - -SVN - command that is run: +SVN command that is run: \family typewriter -snv - add -q +snv add -q \begin_inset Quotes eld \end_inset @@ -20518,8 +18246,7 @@ snv \begin_layout Standard Read \family typewriter -man -svn +man svn \family default to understand the switches. @@ -20534,15 +18261,11 @@ Check In Changes \begin_layout Standard When you are finished editing a file, you commit your changes. When you do this, you are asked for a description of the changes. - After that changes are -commited -. + After that changes are commited. \end_layout \begin_layout Standard - -SVN - command: +SVN command: \begin_inset Foot status collapsed @@ -20562,8 +18285,7 @@ reference "subsec:SVN-File-Locking" \family typewriter -svn - commit -q -m"" +svn commit -q -m"" \end_layout \begin_layout Subsubsection @@ -20574,16 +18296,12 @@ Check Out For Edit \begin_layout Standard Updates the changes of this file from the repository. - Be sure you understand -SVN - merging and conflicts resolving before using this function, because all - conflicts has to be done manually by you! + Be sure you understand SVN merging and conflicts resolving before using + this function, because all conflicts has to be done manually by you! \end_layout \begin_layout Standard - -SVN - command: +SVN command: \begin_inset Foot status collapsed @@ -20595,8 +18313,7 @@ Ditto. \family typewriter -svn - update +svn update \begin_inset Quotes eld \end_inset @@ -20621,12 +18338,9 @@ This will discard all changes made to the document since the last check \end_layout \begin_layout Standard - -SVN - command: +SVN command: \family typewriter -svn - revert -q +svn revert -q \begin_inset Quotes eld \end_inset @@ -20644,13 +18358,10 @@ Show History \end_layout \begin_layout Standard -This show the complete history of the -SVN - document. +This show the complete history of the SVN document. The output of \family typewriter -svn - log +svn log \begin_inset Quotes eld \end_inset @@ -20684,50 +18395,31 @@ The file exchange through various revision control systems brings the problem \end_layout \begin_layout Standard - -SVN - has two mechanisms to provide such kind of mutual exclusivity for file - access - locks and -automatical - setting of write permissions based on +SVN has two mechanisms to provide such kind of mutual exclusivity for file + access - locks and automatical setting of write permissions based on \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -svn -:needs-lock +svn:needs-lock \end_layout \end_inset - file -svn - property + file svn property \begin_inset Foot status collapsed \begin_layout Plain Layout - -http -:// -svnbook -.red-bean.com/en/1.2/ -svn -.advanced.locking. -html +http://svnbook.red-bean.com/en/1.2/svn.advanced.locking.html \end_layout \end_inset . In a case this property is detected for a given document LyX starts to - use -SVN - locks for document editing automatically and the whole check-in/out mechanism - switches to the same regimen as for -RCS -. + use SVN locks for document editing automatically and the whole check-in/out + mechanism switches to the same regimen as for RCS. This in particular means there are two different modes how file is used in LyX: \end_layout @@ -20735,9 +18427,7 @@ RCS \begin_layout Itemize Unlocked state. The loaded file is in the read-only mode. - For -editation - on needs to check-out. + For editation on needs to check-out. \emph on Check-out @@ -20748,17 +18438,13 @@ Check-out \begin_layout Itemize Locked state. - The loaded file is in the -'normal' - edit mode. + The loaded file is in the 'normal' edit mode. No other user is allowed to edit the file. \emph on Check-in \emph default - consists of -commiting - changes and releasing write-lock. + consists of commiting changes and releasing write-lock. If no changes have been made to the document, no commit will be produced \begin_inset Foot status collapsed @@ -20773,52 +18459,39 @@ Don't be puzzled by the fact that you will be asked for commit message anyway. \end_layout \begin_layout Standard - -SVN - commands: +SVN commands: \end_layout \begin_layout Labeling \labelwidthstring 00.00.0000 Check-in: \family typewriter - -svn - commit -q -m"" "" + svn commit -q -m"" "" \begin_inset Newline newline \end_inset - -svn - unlock "" +svn unlock "" \end_layout \begin_layout Labeling \labelwidthstring 00.00.0000 Check-out: \family typewriter -svn - update "" +svn update "" \begin_inset Newline newline \end_inset - -svn - lock "" +svn lock "" \end_layout \begin_layout Subsection - -SVN - and Windows Environment +SVN and Windows Environment \end_layout \begin_layout Quote My inclination is to say that if the user cannot figure out the command line operations on their own fairly quickly, they would be well advised - to use -TortoiseSVN -. + to use TortoiseSVN. ---P. A. Rubin @@ -20848,15 +18521,12 @@ target "http://tortoisesvn.tigris.org/" \end_inset -, which integrates Subversion operations into the context ( -rightclick -) menu of Windows Explorer. +, which integrates Subversion operations into the context (rightclick) menu + of Windows Explorer. Operations done outside LyX will typically be more convenient using the Explorer context menu. - Note that -TortoiseSVN - is not a replacement for the client program, which is what LyX itself will - use. + Note that TortoiseSVN is not a replacement for the client program, which + is what LyX itself will use. \end_layout \begin_layout Subsubsection @@ -20874,13 +18544,11 @@ Before a LyX document can be brought under version control in Subversion, the repository. This is done outside LyX. Both import and checkout are easily accomplished from the Explorer context - menu using -TortoiseSVN -, or alternatively can be done using the command line client at a DOS prompt. - The procedure for importing the project using -TortoiseSVN - is described below, assuming an existing repository and a new project being - started in + menu using TortoiseSVN, or alternatively can be done using the command + line client at a DOS prompt. + The procedure for importing the project using TortoiseSVN is described + below, assuming an existing repository and a new project being started + in \family typewriter C: \backslash @@ -20889,8 +18557,7 @@ new project . For information on using the Subversion client program, run \family typewriter -svn - --help +svn --help \family default in a DOS shell. \end_layout @@ -20904,10 +18571,7 @@ new project \family default in Windows Explorer, right click it, and select \family typewriter -TortoiseSVN - > -Repo --browser +TortoiseSVN > Repo-browser \family default . If necessary, adjust the URL for the repository, then click OK. @@ -20933,11 +18597,9 @@ C: \backslash new project \family default -, this time selecting -SVN - Checkout\SpecialChar \ldots{} - Select the URL of the project folder you just created in the repositor -y, and set the checkout directory to +, this time selecting SVN Checkout\SpecialChar \ldots{} + Select the URL of the project folder + you just created in the repository, and set the checkout directory to \family typewriter C: \backslash @@ -20948,8 +18610,7 @@ new project. You will be warned about a non-empty folder; click OK to proceed. You should now have a \family typewriter -. -svn +.svn \family default directory under \family typewriter @@ -21004,10 +18665,8 @@ Control menu. You also have the option of checking the document in and out, viewing its history, etc. - using the -TortoiseSVN - context menu in Windows Explorer or the Subversion client program from - a command prompt. + using the TortoiseSVN context menu in Windows Explorer or the Subversion + client program from a command prompt. \end_layout \begin_layout Subsection @@ -21015,16 +18674,13 @@ Further tuning \end_layout \begin_layout Standard -With the recent addition of the -vc --command function LyX power users are allowed to create their own commands - for revision control. +With the recent addition of the vc-command function LyX power users are + allowed to create their own commands for revision control. \end_layout \begin_layout Standard -As an example you can see how two -TortoiseSVN - commands could be integrated directly: +As an example you can see how two TortoiseSVN commands could be integrated + directly: \end_layout \begin_layout Description @@ -21033,11 +18689,7 @@ Commit: status collapsed \begin_layout Plain Layout - -vc --command DR "." " -TortoiseProc - /command:commit /path:$$p" +vc-command DR "." "TortoiseProc /command:commit /path:$$p" \end_layout \end_inset @@ -21051,11 +18703,7 @@ Revert: status collapsed \begin_layout Plain Layout - -vc --command DR "." " -TortoiseProc - /command:revert /path:$$p" +vc-command DR "." "TortoiseProc /command:revert /path:$$p" \end_layout \end_inset @@ -21070,28 +18718,18 @@ Literate Programming \begin_layout Standard Updated by \noun on -Kayvan - Sylvan +Kayvan Sylvan \noun default -( -kayvan -@sylvan.com) +(kayvan@sylvan.com) \noun on , \noun default original documentation written by \noun on -Edmar - -Wienskoski - Jr. +Edmar Wienskoski Jr. \noun default - ( -edmar --w- -jr -@technologist.com) + (edmar-w-jr@technologist.com) \end_layout \begin_layout Subsection @@ -21214,9 +18852,7 @@ http://shelob.ce.ttu.edu/daves/lpfaq/faq.html \end_layout \begin_layout Standard -The FAQ lists -23 - (twenty three!) different literate programming tools. +The FAQ lists 23 (twenty three!) different literate programming tools. Where some are specialized or \begin_inset Quotes eld \end_inset @@ -21234,9 +18870,7 @@ Noweb \end_layout \begin_layout Itemize -It can generate the documentation either in -LaTeX - or HTML. +It can generate the documentation either in LaTeX or HTML. \end_layout \begin_layout Itemize @@ -21263,15 +18897,11 @@ It is free. \end_layout \begin_layout Standard -The -Noweb - web page can be found at: +The Noweb web page can be found at: \end_layout \begin_layout Quote - -Noweb - home page +Noweb home page \begin_inset Flex URL status collapsed @@ -21301,9 +18931,7 @@ The LyX support for Literate Programming is provided by using the generic \begin_inset Quotes eld \end_inset - -Noweb - independent +Noweb independent \begin_inset Quotes erd \end_inset @@ -21328,29 +18956,21 @@ Selecting the document class \end_layout \begin_layout Standard -If you have installed -Noweb - and LyX successfully, whenever you open a new document or try to change - the document class of an existing one, you will find that there are three - new document classes available: +If you have installed Noweb and LyX successfully, whenever you open a new + document or try to change the document class of an existing one, you will + find that there are three new document classes available: \end_layout \begin_layout Itemize -Article ( -Noweb -) +Article (Noweb) \end_layout \begin_layout Itemize -Book ( -Noweb -) +Book (Noweb) \end_layout \begin_layout Itemize -Report ( -Noweb -) +Report (Noweb) \end_layout \begin_layout Standard @@ -21361,18 +18981,10 @@ You must select one of them to create your literate documents from. \begin_layout Standard Note that literate documents are not limited to these three classes. New classes can be generated from other styles like letter or in combination - with other class variations like Article ( -AMS -). + with other class variations like Article (AMS). If you have special needs that cannot be covered by one of the existing - classes, let the LyX developers list ( -lyx -- -devel -@lists. -lyx -.org) know and we will arrange to insert a new entry, or teach you how to - do it. + classes, let the LyX developers list (lyx-devel@lists.lyx.org) know and we + will arrange to insert a new entry, or teach you how to do it. \begin_inset Foot status collapsed @@ -21383,9 +18995,8 @@ It is very simple, it involves the creation of a file with four lines, and \end_inset - Moreover, if you use a literate tool other than -Noweb - you may need to create a new set of document classes for it. + Moreover, if you use a literate tool other than Noweb you may need to create + a new set of document classes for it. \end_layout \begin_layout Paragraph @@ -21402,9 +19013,7 @@ Scrap status collapsed \begin_layout Plain Layout -The equivalent -Noweb - term is +The equivalent Noweb term is \begin_inset Quotes eld \end_inset @@ -21421,18 +19030,13 @@ scrap \begin_inset Quotes erd \end_inset - introduced by other literate tool named -Nuweb -, which I used for many years before rendering myself to -Noweb -. + introduced by other literate tool named Nuweb, which I used for many years + before rendering myself to Noweb. \end_layout \end_inset - -Noweb - delimits scraps like this: + Noweb delimits scraps like this: \end_layout \begin_layout LyX-Code @@ -21479,9 +19083,7 @@ The down side of the Scrap paragraph layout is that consecutive paragraphs of code will be spaced with one empty line in the source code and also in the printed documentation. The work around is to enter each line of code within a single Scrap, with - a newline ( -ctrl --return). + a newline (ctrl-return). The example above will look like this: \begin_inset Foot status collapsed @@ -21518,9 +19120,8 @@ If you have a printed version of this document you will not see any difference \begin_layout Standard This layout works fine. - The only real inconvenience is that you have to type -ctrl --return instead of a plain return. + The only real inconvenience is that you have to type ctrl-return instead + of a plain return. \begin_inset Foot status collapsed @@ -21550,11 +19151,8 @@ As a special note, you can also use the \begin_inset Quotes erd \end_inset - construct of -Noweb - in your scraps to add items to -Noweb's - identifier cross-reference: + construct of Noweb in your scraps to add items to Noweb's identifier cross-refe +rence: \end_layout \begin_layout LyX-Code @@ -21562,9 +19160,7 @@ Noweb's \begin_inset Newline newline \end_inset - def some_function( -args -): + def some_function(args): \begin_inset Newline newline \end_inset @@ -21572,10 +19168,7 @@ args \begin_inset Newline newline \end_inset - print "My -args -: ", -args + print "My args: ", args \end_layout \begin_layout LyX-Code @@ -21586,11 +19179,7 @@ args For an example of this usage and the resulting cross-reference output, look at the Literate python program in \emph on -LIBDIR -/examples/ -listerrors -. -lyx +LIBDIR/examples/listerrors.lyx \emph default which should make this all clear. \end_layout @@ -21605,9 +19194,7 @@ At this point you already have a new document file with a proper document How do I print it? The answer is simple, you select \family sans View\SpecialChar \menuseparator - -DVI -, +DVI, \family default etc. Just like you would do for a plain document. @@ -21622,12 +19209,9 @@ To help orientate you, I will now explain what happens inside LyX: When the \family sans Update\SpecialChar \menuseparator - DVI \family default - menu option is chosen, a -LaTeX - file is generated. + menu option is chosen, a LaTeX file is generated. \end_layout @@ -21645,8 +19229,7 @@ literate format (defined in the Preferences panel), otherwise the file will have the usual \family typewriter -. -tex +.tex \family default extension. \end_layout @@ -21661,13 +19244,7 @@ Note that the only difference so far is in the name of the file, no special \begin_layout Enumerate If the document is of any literate class LyX will then use the internal - LyX to -Noweb - converter, followed by the -Noweb - to -LaTeX - converter + LyX to Noweb converter, followed by the Noweb to LaTeX converter \begin_inset Foot status collapsed @@ -21699,9 +19276,7 @@ Customization \end_inset - to generate the -LaTeX - file. + to generate the LaTeX file. \end_layout \begin_deeper @@ -21711,9 +19286,8 @@ Otherwise it will just skip this step. \end_deeper \begin_layout Enumerate -Finally, -LaTeX - is invoked and the regular post processing continues as in a plain document. +Finally, LaTeX is invoked and the regular post processing continues as in + a plain document. \end_layout \begin_layout Standard @@ -21735,13 +19309,10 @@ Generating the code \begin_layout Standard When the build menu option is chosen or the corresponding button in the - toolbar is pressed, a -LaTeX - file is generated just like step 1 above. + toolbar is pressed, a LaTeX file is generated just like step 1 above. Next, LyX invokes the \family typewriter -Noweb -->Program +Noweb->Program \family default converter. This converter needs to be defined by the user and is not installed by @@ -21752,9 +19323,7 @@ Noweb \begin_layout Enumerate The converter program itself. This program performs the conversion from the one format to the other (in - this case, from the -Noweb - format to the Program pseudo-format). + this case, from the Noweb format to the Program pseudo-format). \end_layout \begin_layout Enumerate @@ -21795,9 +19364,8 @@ build-script \begin_inset Quotes erd \end_inset - (a program or script) with the name of the -Noweb - file (normally a file in the LyX temp directory). + (a program or script) with the name of the Noweb file (normally a file + in the LyX temp directory). \end_layout @@ -21822,15 +19390,7 @@ build-script \end_layout \begin_layout LyX-Code - -notangle - - -Rbuild --script $1 | -env - -NOWEB -_SOURCE=$1 sh +notangle -Rbuild-script $1 | env NOWEB_SOURCE=$1 sh \end_layout \begin_layout Standard @@ -21848,9 +19408,7 @@ Flags \family typewriter -parselog -= -listerrors +parselog=listerrors \family default \begin_inset Quotes erd @@ -21869,9 +19427,7 @@ build-script \begin_inset Quotes eld \end_inset - listerrors - \begin_inset Quotes erd \end_inset @@ -21881,21 +19437,17 @@ listerrors \begin_layout Standard The converter code looks in \emph on -MYLYXDIR -/scripts +MYLYXDIR/scripts \emph default first, then in \emph on -LIBDIR -/scripts +LIBDIR/scripts \emph default then on the path for the \begin_inset Quotes eld \end_inset - listerrors - \begin_inset Quotes erd \end_inset @@ -21905,18 +19457,13 @@ listerrors \begin_layout Standard The build will normally take place in LyX's temporary directory, so the files produced by the conversion will be in that directory. - LyX will copy out what it regards as the ` -main' - file, but the + LyX will copy out what it regards as the `main' file, but the \family typewriter -Noweb -->Program +Noweb->Program \family default conversion may produce several files, and so most of these would then be deleted when LyX was closed. - The present solution is to use a ` -copier' -, + The present solution is to use a `copier', \begin_inset Foot status collapsed @@ -21936,8 +19483,7 @@ Customization in this case, the \family typewriter -ext_copy. -py +ext_copy.py \family default script in its default mode, so that the entire contents of the temporary directory is copied. @@ -21966,11 +19512,7 @@ ext_copy \end_layout \begin_layout LyX-Code -python - -tt - $$s/scripts/ext_copy. -py - -e c,h $$i $$o +python -tt $$s/scripts/ext_copy.py -e c,h $$i $$o \end_layout \begin_layout Standard @@ -21983,9 +19525,7 @@ Build instructions in the document \end_layout \begin_layout Standard -The last piece of the integration between LyX and -noweb - is the +The last piece of the integration between LyX and noweb is the \begin_inset Quotes eld \end_inset @@ -21996,9 +19536,7 @@ build-script scrap. Generally, the instructions for building your program should be embedded in a scrap of its own. - The -noweb --specific + The noweb-specific \begin_inset Quotes eld \end_inset @@ -22006,9 +19544,7 @@ build-script \begin_inset Quotes erd \end_inset - above uses the -notangle - command to look for this scrap (called + above uses the notangle command to look for this scrap (called \begin_inset Quotes eld \end_inset @@ -22044,9 +19580,7 @@ Typically, such a scrap would look something like this: \begin_inset Newline newline \end_inset -if [ -z "${ -NOWEB -_SOURCE}" ] +if [ -z "${NOWEB_SOURCE}" ] \begin_inset Newline newline \end_inset @@ -22054,19 +19588,11 @@ then \begin_inset Newline newline \end_inset - -NOWEB -_SOURCE= -myfile -. -nw - + NOWEB_SOURCE=myfile.nw \begin_inset Newline newline \end_inset - fi - \begin_inset Newline newline \end_inset @@ -22086,43 +19612,29 @@ fi \begin_layout Standard Look in \emph on -LIBDIR -/examples/ -listerrors -. -lyx +LIBDIR/examples/listerrors.lyx \emph default or in \emph on -LIBDIR -/examples/Literate. -lyx +LIBDIR/examples/Literate.lyx \emph default which implement two versions of the \begin_inset Quotes eld \end_inset - listerrors - \begin_inset Quotes erd \end_inset program for some illustrations of how all of these pieces go together or in \emph on -LIBDIR -/examples/ -noweb2lyx -. -lyx -. +LIBDIR/examples/noweb2lyx.lyx. \emph default - Interestingly, these three files show off the language- -indepence - of the LyX literate programming support since they are written in Python, - C and Perl respectively. + Interestingly, these three files show off the language-indepence of the + LyX literate programming support since they are written in Python, C and + Perl respectively. \end_layout \begin_layout Subsubsection @@ -22164,9 +19676,8 @@ literate \begin_inset space ~ \end_inset -format Set up via the Formats tab, this is where the -Noweb --specific pieces are set up. +format Set up via the Formats tab, this is where the Noweb-specific pieces + are set up. The \family sans GUI Name @@ -22177,14 +19688,12 @@ NoWeb \family default , the file extension is set to \family typewriter -. -nw +.nw \family default . This tells LyX to create a file with a \family typewriter -. -nw +.nw \family default extension in the first step of the conversion process. \end_layout @@ -22224,16 +19733,13 @@ weaving \end_inset of the literate document. - For -Noweb -, it is set to + For Noweb, it is set to \begin_inset Quotes eld \end_inset \family typewriter -noweave - -delay -index $$i > $$o +noweave -delay -index $$i > $$o \family default \begin_inset Quotes erd @@ -22278,11 +19784,7 @@ build-script $$i \family typewriter -originaldir -, -parselog -= -listerrors +originaldir,parselog=listerrors \family default \begin_inset Quotes erd @@ -22300,30 +19802,15 @@ There is also a new function implemented in the LyX server, the \begin_inset Quotes eld \end_inset -server- -goto --file-row" function, to be used with -ddd -/ -gdb - or other debugger. +server-goto-file-row" function, to be used with ddd/gdb or other debugger. \end_layout \begin_layout Standard -When debugging code with -ddd -/ -gdb -, it is possible to invoke a text editor at the current execution position - with a single key stroke. - The default -ddd - configuration for that is shift- -ctrl --V. - It happens that you can define the editor command line invocation in -ddd +When debugging code with ddd/gdb, it is possible to invoke a text editor + at the current execution position with a single key stroke. + The default ddd configuration for that is shift-ctrl-V. + It happens that you can define the editor command line invocation in ddd by accessing the \family sans Edit\SpecialChar \menuseparator @@ -22334,9 +19821,8 @@ Helpers \end_layout \begin_layout Standard -I take advantage of the new created LyX server function and this -ddd - feature, and set +I take advantage of the new created LyX server function and this ddd feature, + and set \begin_inset Quotes eld \end_inset @@ -22348,29 +19834,15 @@ Edit Sources \end_layout \begin_layout LyX-Code -echo " -LYXCMD -:monitor:server- -goto --file-row:@FILE@ @LINE@" >~/. -lyxpipe -.in +echo "LYXCMD:monitor:server-goto-file-row:@FILE@ @LINE@" >~/.lyxpipe.in \end_layout \begin_layout Standard -With this, whenever you are using -ddd - and find a point in the program that you want to edit, you just press shift- -ctrl --V (in the -ddd - window), and -ddd - you forward this information to LyX through the LyX server and then the - LyX window will show the same file with the cursor at the same position - -ddd - was pointing to. +With this, whenever you are using ddd and find a point in the program that + you want to edit, you just press shift-ctrl-V (in the ddd window), and + ddd you forward this information to LyX through the LyX server and then + the LyX window will show the same file with the cursor at the same position + ddd was pointing to. No more guessing or long scrolling to locate a point in the program back from debugging ! \end_layout @@ -22392,8 +19864,7 @@ Paths \family default ) by entering in the \family sans -LyXserver - pipe +LyXserver pipe \family default a path like \begin_inset Quotes eld @@ -22401,10 +19872,7 @@ LyXserver \family typewriter -/home//. -lyx -/ -lyxpipe +/home//.lyx/lyxpipe \family default \begin_inset Quotes erd @@ -22480,7 +19948,6 @@ DVI and the other for \family sans View\SpecialChar \menuseparator - DVI \family default File menu entries. @@ -22504,9 +19971,7 @@ Toolbar \end_layout \begin_layout LyX-Code - Icon "layout -LaTeX -" + Icon "layout LaTeX" \end_layout \begin_layout LyX-Code @@ -22563,13 +20028,10 @@ There are a number of colors in LyX that can be customized in Preferences \family default . - One of the things that bothers people is the -LaTeX - font color. - The default color is red, since the scraps uses -LaTeX - font, and there is a lot of scraps in literate documents, you may get tired - of seeing everything in red. + One of the things that bothers people is the LaTeX font color. + The default color is red, since the scraps uses LaTeX font, and there is + a lot of scraps in literate documents, you may get tired of seeing everything + in red. You can change it by going to the tabs \family sans Look&Feel @@ -22590,9 +20052,7 @@ The next thing is the visible presence of the newline character in the screen. \end_layout \begin_layout Chapter -Secrets of the -LaTeX - Masters +Secrets of the LaTeX Masters \begin_inset CommandInset label LatexCommand label name "cha:secrets" @@ -22604,13 +20064,9 @@ name "cha:secrets" \begin_layout Standard Though LyX is a powerful tool, it cannot hope to support everything that - can be done with pure TeX/ -LaTeX -. - However, many familiar dirty TeX and -LaTeX - tricks can be done within LyX, as long as you are not afraid to use that - + can be done with pure TeX/LaTeX. + However, many familiar dirty TeX and LaTeX tricks can be done within LyX, + as long as you are not afraid to use that \begin_inset Quotes eld \end_inset @@ -22618,9 +20074,7 @@ TeX \begin_inset Quotes erd \end_inset - button on the toolbar or add things to the -LaTeX - preamble. + button on the toolbar or add things to the LaTeX preamble. This section lists some tips, tricks, and otherwise cool ideas to give your document that extra little flair. @@ -22632,18 +20086,11 @@ Do try this at home \end_layout \begin_layout Standard -Most ideas in this section require less common files in your -LaTeX - installation. - If you have a system like -teTeX -, most will already be available. - A few, however, will need to be downloaded from one of the -CTAN - archives. - Often, there are several ways to do something, or several -LaTeX - style files which do the same thing. +Most ideas in this section require less common files in your LaTeX installation. + If you have a system like teTeX, most will already be available. + A few, however, will need to be downloaded from one of the CTAN archives. + Often, there are several ways to do something, or several LaTeX style files + which do the same thing. We do not endorse one choice over another, we simply claim that we have done a particular task with a particular file. Put on your wizard hat, keep an eye out for dragons, and let us begin. @@ -22656,10 +20103,7 @@ Multiple Columns \begin_layout Standard by \noun on -Lars -Gullik - -Bjønnes +Lars Gullik Bjønnes \end_layout \begin_layout Subsection @@ -22672,9 +20116,8 @@ The aim for this chapter status collapsed \begin_layout Plain Layout -Editor's note: -Lars' - original chapter was a masterful description of how to use the +Editor's note: Lars' original chapter was a masterful description of how + to use the \family typewriter multicol \family default @@ -22684,21 +20127,15 @@ multicol Lars); you can read the original chapter (and more of the story!) in the example file \family typewriter -examples/ -multicol -. -lyx +examples/multicol.lyx \family default . - — -mer + — mer \end_layout \end_inset - is to show how the -LaTeX - package + is to show how the LaTeX package \family typewriter multicol \family default @@ -22707,9 +20144,7 @@ multicol \family typewriter multicol \family default - package -natively - yet, we have to use some small hacks. + package natively yet, we have to use some small hacks. By reading this section it should be obvious how to do this. \end_layout @@ -22722,14 +20157,12 @@ The \family typewriter multicol \family default - package allows switching between one and -multicolumn - format on the same page. + package allows switching between one and multicolumn format on the same + page. Footnotes are handled correctly (for the most part), but will be placed at the bottom of the page and not under each column. - -LaTeX's - float mechanism, however, is partly disabled in the current implementation. + LaTeX's float mechanism, however, is partly disabled in the current implementat +ion. At the moment only page-wide floats can be used within the scope of the environment. \end_layout @@ -22743,23 +20176,18 @@ Two columns \end_layout \begin_layout Standard -If you want to have two columns in your text, you have use -LaTeX - mode to insert +If you want to have two columns in your text, you have use LaTeX mode to + insert \family typewriter \backslash -begin{ -multicols -}{2} +begin{multicols}{2} \family default at the point where you want the two column layout to start, and then \family typewriter \backslash -end{ -multicols -} +end{multicols} \family default where you want it to end. Like this: @@ -22800,12 +20228,9 @@ Sir Arthur Conan Doyle \begin_layout Standard \size small -It was in the spring of the year -1894 - that all London was interested, and the fashionable world dismayed, by - the murder of the -Honourable - Ronald Adair under most unusual and inexplicable circumstances. +It was in the spring of the year 1894 that all London was interested, and + the fashionable world dismayed, by the murder of the Honourable Ronald + Adair under most unusual and inexplicable circumstances. The public has already learned those particulars of the crime which came out in the police investigation, but a good deal was suppressed upon that occasion, since the case for the prosecution was so overwhelmingly strong @@ -22938,16 +20363,11 @@ begin{multicols}{2} \begin_layout Standard \size footnotesize -The -Honourable - Ronald Adair was the second son of the Earl of -Maynooth -, at that time governor of one of the Australian colonies. +The Honourable Ronald Adair was the second son of the Earl of Maynooth, + at that time governor of one of the Australian colonies. Adair's mother had returned from Australia to undergo the operation for cataract, and she, her son Ronald, and her daughter Hilda were living together - at -427 - Park Lane. + at 427 Park Lane. \end_layout \begin_layout Standard @@ -22971,22 +20391,14 @@ begin{multicols}{2} \size footnotesize The youth moved in the best society–had, so far as was known, no enemies and no particular vices. - He had been engaged to Miss Edith -Woodley -, of -Carstairs -, but the engagement had been broken off by mutual consent some months before, - and there was no sign that it had left any very profound feeling behind - it. + He had been engaged to Miss Edith Woodley, of Carstairs, but the engagement + had been broken off by mutual consent some months before, and there was + no sign that it had left any very profound feeling behind it. For the rest {sic} the man's life moved in a narrow and conventional circle, for his habits were quiet and his nature unemotional. Yet it was upon this easy-going young aristocrat that death came, in most strange and unexpected form, between the hours of ten and eleven-twenty - on the night of March -30 -, -1894 -. + on the night of March 30, 1894. \end_layout \begin_layout Standard @@ -23028,11 +20440,7 @@ The evidence of those who had played with him– Mr. player, and usually rose a winner. It came out in evidence that, in partnership with Colonel Moran, he had actually won as much as four hundred and twenty pounds in a sitting, some - weeks before, from Godfrey -Milner - and Lord -Balmoral -. + weeks before, from Godfrey Milner and Lord Balmoral. So much for his recent history as it came out at the inquest. \end_layout @@ -23055,10 +20463,7 @@ end{multicols} \begin_layout Standard Please do read the file \family typewriter -examples/ -multicol -. -lyx +examples/multicol.lyx \family default for more advanced examples including column and header spacing, vertical separator lines, and more. @@ -23110,71 +20515,41 @@ Enumerate \begin_layout LyX-Code \backslash - -renewcommand -{ +renewcommand{ \backslash - -labelenumi -}{ +labelenumi}{ \backslash -Roman{ -enumi -}.} +Roman{enumi}.} \end_layout \begin_layout LyX-Code \backslash - -renewcommand -{ +renewcommand{ \backslash - -labelenumii -}{ +labelenumii}{ \backslash - -Alph -{ -enumii -}.} +Alph{enumii}.} \end_layout \begin_layout LyX-Code \backslash - -renewcommand -{ +renewcommand{ \backslash - -labelenumiii -}{ +labelenumiii}{ \backslash - -arabic -{ -enumiii -}.} +arabic{enumiii}.} \end_layout \begin_layout LyX-Code \backslash - -renewcommand -{ +renewcommand{ \backslash - -labelenumiv -}{ +labelenumiv}{ \backslash - -alph -{ -enumiv -}.)} +alph{enumiv}.)} \end_layout \begin_layout Standard @@ -23250,7 +20625,6 @@ As you can see in the example, there is a label command for each nesting \family typewriter \backslash - labelenumi \family default \SpecialChar \ldots{} @@ -23258,7 +20632,6 @@ labelenumi \family typewriter \backslash - labelenumiv \family default , as well as a counter, @@ -23283,9 +20656,7 @@ number printing \family typewriter \backslash - -arabic -{} +arabic{} \family default , \family typewriter @@ -23303,17 +20674,13 @@ Roman{} \family typewriter \backslash - -alph -{} +alph{} \family default , and \family typewriter \backslash - -Alph -{} +Alph{} \family default , each of which take one counter as an argument. You can add characters before or after these, but there's no need to add @@ -23328,21 +20695,13 @@ You can get really fancy with these. \begin_layout LyX-Code \backslash - -renewcommand -{ +renewcommand{ \backslash - -labelenumi -}{ +labelenumi}{ \backslash # \backslash - -Alph -{ -enumi -} +Alph{enumi} \backslash #} \end_layout @@ -23350,59 +20709,33 @@ enumi \begin_layout LyX-Code \backslash - -renewcommand -{ +renewcommand{ \backslash - -labelenumii -}{ +labelenumii}{ \backslash - -Alph -{ -enumi -}. +Alph{enumi}. \backslash - -arabic -{ -enumii -}} +arabic{enumii}} \end_layout \begin_layout LyX-Code \backslash - -renewcommand -{ +renewcommand{ \backslash - -labelenumiii -}{ +labelenumiii}{ \backslash - -alph -{ -enumiii -}+} +alph{enumiii}+} \end_layout \begin_layout LyX-Code \backslash - -renewcommand -{ +renewcommand{ \backslash - -labelenumiv -}{( +labelenumiv}{( \backslash -roman{ -enumiv -})} +roman{enumiv})} \end_layout \begin_layout Standard @@ -23465,8 +20798,7 @@ Dropped Capitals \begin_layout Standard by \noun on -Mike -Ressler +Mike Ressler \end_layout \begin_layout Standard @@ -23524,11 +20856,10 @@ dropped capitals \end_inset —those large capital letters which begin each new chapter or section. - Implementing them with plain LyX/ -LaTeX - is straightforward (assuming you know some plain TeX!) but does require - a lot of work and many iterations, as you can see by all the ugly TeX-mode - stuff at the beginning of this paragraph. + Implementing them with plain LyX/LaTeX is straightforward (assuming you + know some plain TeX!) but does require a lot of work and many iterations, + as you can see by all the ugly TeX-mode stuff at the beginning of this + paragraph. \end_layout \begin_layout Standard @@ -23555,13 +20886,10 @@ dropcaps \family typewriter dropping \family default -) package from -CTAN - allows a simple way to add such letters to your documents. - Since this package is not a standard part of -teTeX -, I can't demonstrate it within this document, but if you copy this paragraph - to a new document, delete the +) package from CTAN allows a simple way to add such letters to your documents. + Since this package is not a standard part of teTeX, I can't demonstrate + it within this document, but if you copy this paragraph to a new document, + delete the \begin_inset Quotes eld \end_inset @@ -23580,15 +20908,9 @@ verb \family typewriter \backslash - -usepackage -{ -dropcaps -} +usepackage{dropcaps} \family default - to your -LaTeX - preamble, you will get a nice Times Roman Italic + to your LaTeX preamble, you will get a nice Times Roman Italic \begin_inset Quotes eld \end_inset @@ -23604,8 +20926,7 @@ T \family typewriter -dropcaps -.sty +dropcaps.sty \family default \begin_inset Quotes erd @@ -23614,14 +20935,10 @@ dropcaps into a directory where TeX can see it.) The first argument is the amount of indentation; in this case the negative sign moves it into the margin. The second argument is the height of the letter in number of lines of text. - The third argument is the font name: virtually anything which has a -tfm + The third argument is the font name: virtually anything which has a tfm file should work (wade through the \family typewriter -.../ -texmf -/fonts/ -tfm +.../texmf/fonts/tfm \family default directory for possibilities). My personal favorite is @@ -23646,7 +20963,6 @@ dropping \family typewriter \backslash - bigdrop \family default command, as well as a slightly simplified @@ -23665,8 +20981,7 @@ Non-standard Paragraph Shapes \begin_layout Standard by \noun on -Mike -Ressler +Mike Ressler \end_layout \begin_layout Standard @@ -23908,19 +21223,14 @@ There are times when the tyranny of rectangular paragraphs must be overthrown. \family typewriter \backslash - parshape \family default is called for. As you can see, completely arbitrary shapes can be laid out with a suitable - set of -linelength - definitions. - While this -parshape - may look a bit silly and useless, one could conceive of situations such - as finely tuned dropped capitals, word wrapping around non-rectangular - graphics, etc. + set of linelength definitions. + While this parshape may look a bit silly and useless, one could conceive + of situations such as finely tuned dropped capitals, word wrapping around + non-rectangular graphics, etc. which will benefit from such handcrafting. \end_layout @@ -23936,23 +21246,8 @@ The syntax is \family typewriter \backslash - -parshape - -numlines - # -1indent - # -1length - # -2indent - # -2length - \SpecialChar \ldots{} - # -nindent - # -nlength +parshape numlines #1indent #1length #2indent #2length \SpecialChar \ldots{} + #nindent #nlength \family default , where \family typewriter @@ -23964,13 +21259,11 @@ numlines definition. The \family typewriter -# -nindent +#nindent \family default and \family typewriter -# -nlength +#nlength \family default entries specify the indentation of the line from the left margin, and the length of the line as measured from that point. @@ -24004,16 +21297,10 @@ As you can see, the examples in this section range from the useful to the While I don't expect that anyone will ever need the paragraph shape demonstrate d in the last section, the important point is that you can do almost anything you want in LyX if you are willing to figure out how to do it in TeX and - -LaTeX -. + LaTeX. TeX is a fantastically powerful typesetting system and all that power is - available to you since LyX uses it as its -backend -. - Happy -LyXing -! + available to you since LyX uses it as its backend. + Happy LyXing! \end_layout \end_body