Dear Uwe As last time, I wasn't able to open Tutorial.lyx from http://wiki.lyx.org/LyX/DocumentationDevelopment either directly or by downloading it to my computer and trying to open it there. So I downloaded the PDF and compared it with my 1.6.4 help file.
Here are my suggestions for chapters 4 and 5. 4.1 Math Mode [third paragraph] Update your viewer and look at the output. [a more appropriate suggestion for a LyX user] [final paragraph] . . . until you run the file under LaTeX and you may have to spend time finding e.g. . . . 4.2 Navigating an Equation [second paragraph] . . . One thing to be careful of: if you . . . [lowercase is normal after a colon] . . . Backspace respectively, . . . [comma not needed here after Backspace] [third paragraph] . . . If you hit Space . . . [more idiomatic] 4.3 Exponents and Indices [The character between 'easy' and 'start' in the second paragraph does not show in the PDF and looks longer than an em-dash in my LyX help file; a colon would be more suitable here as the em-dash is nowadays normally used for things that are 'outside' the main argument rather than for something that is part of it. Though the comma after 'key' is grammatically correct, it could probably be omitted; however the closing double inverted commas need to be \textquotedblright.] 4.4 The Math Toolbar [At the end of the first paragraph, would it be worth giving a citation or cross-reference to where people can find this information?] [second paragraph] The Math toolbar . . . [Math uppercase for consistency] 4.4.1 Greek and symbols The Math Toolbar allows you . . . used in math: operators, arrows, relationships, delimiters, special characters, sums and integrals. [the existing list doesn't really convey the scope of the options] 4.4.2 Square roots, accents, and delimiters [second paragraph] . . . that have a fixed size . . . [fourth paragraph] . . . So it is better in this case to use one of the . . . 4.4.4 TEX mode: Limits, log, sin and others [I don't see the point of TEX mode here; also, in English maths, 'limits' is normally taken to refer to the superscripts and subscripts of integrals and the subscripts of sum. I suggest the heading should simply be 'Log, sin and others'] [third paragraph] The function list includes . . . 4.4.6 Display mode [second paragraph] . . . in the Math Toolbar, which creates a couple of blank lines before and after a centered blue box. Now type an expression in the blue box and run or update your viewer to see how it looks. . . . [the extra sentence adds nothing] [second bullet point] . . . written under and over rather than next . . . [final paragraph] . . . typeset: be careful . . . [lowercase after colon] . . . That text will be indented or follow a blank line, depending . . . 4.5 More Math Stuff LYX’s math editor can do a lot more. Now you’re familiar with the basics, you can refer to the User’s Guide for tips on how to: • Label and number expressions • Create multi-line equations . . . • Do lots of other things that we have’t space for in this Tutorial. 5.2.1 TEX Mode [third paragraph] As a special case, if you type a brace in TeX mode, then the beginning and ending braces will be inserted in red; the cursor will then be taken out of TeX mode and placed between the braces. This makes it more convenient to type those commands which take an argument that LyX doesn't know about. [In the final paragraph the character between 'you want' and 'although' does not display in the PDF and appears to be longer than an em-dash in the LyX help. An em-dash would be appropriate here but maybe it needs to entered with --- to make it display properly in the PDF.] 5.2.2 Importing LaTeX Documents — tex2lyx [second paragraph] . . . TeX mode; so, after translating a file with tex2lyx, you can look for the red text and manually edit it get it right. [comma to semi-colon and additional comma as well as some changes to the text] [third paragraph] . . . the LaTeX commands and environments that aren't supported, . . . 5.2.4.1 Document Class . . . in the Class options. [I cannot see any 'Extra options'] 5.2.4.2 Other Preamble Matter . . . will (as with TeX mode) . . . 5.3 Errors! Sometimes, when you try to view a document, there . . . --- Finally, following our discussion of inverted commas last time, I have been reading a couple of books printed in England in 1825 and 1828. I was interested to see that they had single inverted commas only for direct reported speech; for quotations from books or where the inverted commas were intended to convey a special meaning for a particular word or phrase, they have double inverted commas. So it looks as if the current British fashion for singe inverted commas may be a simplification of an earlier, more differentiated approach. John
