Changeset 9330bfb in rtems-docs


Ignore:
Timestamp:
Nov 9, 2016, 6:08:05 AM (4 years ago)
Author:
Chris Johns <chrisj@…>
Branches:
4.11, 5, am, master
Children:
58c815c, 6297ad3
Parents:
5431beb
Message:

waf: Users without the extra fonts need to use '--disable-extra-fonts' to build PDF.

Files:
3 edited

Legend:

Unmodified
Added
Removed
  • README.txt

    r5431beb r9330bfb  
    1919 SIngle HTML - Single HTML, one file per manual.
    2020
    21 The PDF format is cerated using Latex and that uses texlive packages. This
     21The PDF format is created using Latex and that uses texlive packages. This
    2222exposes us to the complex world of Latex however the quality of the documents
    2323created is worth it.
     
    230230To build enter in the top directory:
    231231
    232   $ ./waf configure [--pdf] [--singlehtml] [--prefix] [--sphinx-verbose]
     232  $ ./waf configure [--pdf] [--singlehtml] [--prefix] \
     233                    [--sphinx-verbose] [--disable-extra-fonts]
    233234  $ ./waf
    234235
    235236The '--pdf' and '--singlehtml' options can be added to configure to build those
    236237output formats.
     238
     239The '--disable-extra-fonts' allows you to build PDF documents with out the
     240fonts we use for a better quality document. Use this option to build without
     241needing the extra fonts accepting you will get poor quality documents.
    237242
    238243To build and install to a specific location:
  • common/latex.py

    r5431beb r9330bfb  
    108108
    109109def configure_tests(conf):
    110 
    111110    #
    112111    # Using a hint from ita (thank you) :
     
    165164        conf.env.RTEMSEXTRAFONTS = 'rtemsextrafonts.sty'
    166165    else:
     166        if not conf.options.disable_extra_fonts:
     167            conf.fatal('Extra fonts not found, install or use --disable-extra-fonts')
    167168        conf.env.RTEMSEXTRAFONTS = 'rtemsextrafonts-null.sty'
  • common/waf.py

    r5431beb r9330bfb  
    204204
    205205def doc_singlehtml(ctx, source_dir, conf_dir):
    206 
    207206    #
    208207    # Use a run command to handle stdout and stderr output from inliner. Using
     
    284283
    285284def cmd_options(ctx):
     285    ctx.add_option('--disable-extra-fonts',
     286                   action = 'store_true',
     287                   default = False,
     288                   help = "Disable building with extra fonts for better quality (lower quality).")
    286289    ctx.add_option('--sphinx-verbose',
    287290                   action = 'store',
Note: See TracChangeset for help on using the changeset viewer.