[task #16297] Add "How to read this manual" section in the book

[Pedram Ashofteh-Ardakani]

Follow-up Comment #4, task #16297 (project gnuastro):

Oh we can actually use the UTF-8 characters in texinfo with the
@U{HEX-NUMBER-HERE} instruction. We can also define MACROs for things we need
that aren't there by default. For example, the \leftarrow in my previous
screenshots can be produced by @U{2190}. The output looks the same in the pdf,
but it actually prints a '←' in the 'info' and 'html' versions instead of a
lame '\leftarrow'.

For example:


@c 'leftarrow' is reserved, so a 'u' prefix
@c better indicates that this is a 'unicode'
@macro uleftarrow
@U{2190}
@end macro


and then simply:


Then use @command{make} with number of processors for faster execution:
@example
$ make -j8 # @uleftarrow{} put number of processors here
@print{} EXAMPLE TEXT
@result{} EXAMPLE RESULT
@end example
@noindent
Or in short, just use:
@example
$ make -j$(nproc)
@end example


Which will produce a beautiful left arrow in pdf, html, and the info.

(file #54159, file #54160, file #54161)

    _______________________________________________________

Additional Item Attachment:

File name: utf8-info.jpg                  Size:15 KB
    <https://file.savannah.gnu.org/file/utf8-info.jpg?file_id=54159>

File name: utf8-pdf.jpg                   Size:16 KB
    <https://file.savannah.gnu.org/file/utf8-pdf.jpg?file_id=54160>

File name: utf8-html.jpg                  Size:17 KB
    <https://file.savannah.gnu.org/file/utf8-html.jpg?file_id=54161>



    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/task/?16297>

_______________________________________________
Message sent via Savannah
https://savannah.gnu.org/