home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / APPS / lout2.lzh / LOUT2 / DOC / TR.BEGIN / s05 < prev    next >
Text File  |  1994-01-25  |  3KB  |  76 lines
  1. @Section
  2.    @Tag { paras }
  3.    @Title { Paragraph breaking }
  4. @Begin
  5. @PP
  6. Lout takes the words or other things making up a paragraph and fills
  7. lines with them.  If two words are separated by one space in the input,
  8. they will be separated by one space in the output; two spaces in, two
  9. spaces out, and so on.  The end of a line counts as one space, and a tab
  10. character as eight.  These spaces are then enlarged to remove ragged line ends.
  11. @PP
  12. This process is called @I paragraph {@I breaking}, and the enlargement
  13. of spaces is @I {line adjustment.}  The @Code "@Break" symbol, which is
  14. most commonly used with displays and list items, affects paragraph
  15. breaking:
  16. @ID @Code {
  17. "@IndentedDisplay ragged @Break {"
  18. "This little paragraph will appear with"
  19. "ragged ends to its lines. }"
  20. }
  21. has result
  22. @IndentedDisplay 4c @Wide ragged @Break {
  23. This little paragraph will appear with
  24. ragged ends to its lines.
  25. }
  26. when placed in a four centimetre column; line adjustment is turned
  27. off.  Also available are @Code "cragged @Break" and {@Code "rragged @Break"},
  28. which centre or right-justify each line respectively after breaking.
  29. @PP
  30. It is also possible to have paragraphs broken in the output at the same
  31. places they are broken in the input, using { @Code "lines @Break" }:
  32. @ID @Code {
  33. "@CenteredDisplay lines @Break @I {"
  34. "Teach me to hear Mermaides singing,"
  35. "Or to keep off envies stinging,"
  36. "     And finde"
  37. "     What winde"
  38. "Serves to'advance an honest minde."
  39. "}"
  40. }
  41. has result
  42. @CenteredDisplay lines @Break @I {
  43. Teach me to hear Mermaides singing,
  44. Or to keep off envies stinging,
  45.      And finde
  46.      What winde
  47. Serves to'advance an honest minde.
  48. }
  49. With @Code "lines @Break" it makes sense to indent individual lines in the
  50. input (except the first), as shown.  To centre or right-justify each line, use
  51. {@Code "clines @Break"} or {@PageMark clines} {@Code "rlines @Break"}.
  52. @PP
  53. The usual method, where Lout fills and adjusts lines, is called
  54. {@Code "adjust @Break"}.  It has a variant called {@Code "outdent @Break"}
  55. which inserts a small space at the beginning of each line except the first.
  56. @PP
  57. The @Code "@Break" symbol also controls hyphenation:  @Code "hyphen"
  58. @Code "@Break" turns it on, @Code "nohyphen" @Code "@Break" turns it
  59. off.  For example, ragged breaking is often done without hyphenation,
  60. like this:
  61. @ID @Code {
  62. "@ID { ragged nohyphen } @Break {"
  63. "This little paragraph will appear with"
  64. "ragged ends to its lines."
  65. "}"
  66. }
  67. To prevent hyphenation in the entire document, see Section
  68. {@NumberOf changes}.  To tell Lout where you would prefer a hyphen to be 
  69. inserted (rarely necessary), use the @Code "&-" symbol:
  70. @ID @Code {
  71. "incent&-iv&-ate"
  72. }
  73. If @Code "&-" occurs directly after a hyphen character, hyphenation will
  74. be permitted but no extra hyphen will be inserted.
  75. @End @Section
  76.