1
0
Fork 0
Commit Graph

65 Commits (d8c065817f6483d4791611d624d66ff47efa2f41)

Author SHA1 Message Date
Mike Gerwitz 0e29ddd5eb doc/design.texi (Design & Architecture): Convert note to notice 2017-03-23 12:16:52 -04:00
Mike Gerwitz a700d275de doc/design.texi (Managing Error State): Add section text 2017-03-23 12:16:52 -04:00
Mike Gerwitz e477b15298 Add @srcref to manual
doc/macros.texi (@srcref): Add macro.
2017-03-23 12:16:52 -04:00
Mike Gerwitz b6c9045008 Add @exnotice to manual
liza.css: Style exnotice
macros.texi (@exnotice): Add macro.
2017-03-23 12:16:52 -04:00
Mike Gerwitz d7b1fd2f18 Better multi-line devnotice styling in manual
* liza.css: Better style multi-line notices with icon.
* macros.texi (@noticestart, @noticeend): Add.  Use instead of @rawnotice.
2017-03-23 12:16:52 -04:00
Mike Gerwitz 0400b5f84c Properly build and format TeX document
This doesn't have formatting (yet?) for notices aside from the basic
italics.

* design.texi: Move @ref's to end of sentence rather than treating as
  links on existing text.  It otherwise formats undesirably in the PDF.
2017-03-23 12:16:52 -04:00
Mike Gerwitz 4ddebbc035 Add SRCURI configuration for manual
* configure.ac (SET_SRCURI): Provide source root to manual.
  (--with-srcuri): Add configure option.
* doc/config.texi.in (SET_SRCURI): Add configuration value.
* doc/liza.texi: Add warning if SET_SRCURI is unset when DEVNOTES is set.
2017-03-23 12:16:52 -04:00
Mike Gerwitz eaacb7c5e0 doc/Makefile.am (liza_TEXINFOS): Depend upon liza.css
To trigger a rebuild when modified.
2017-03-23 12:16:52 -04:00
Mike Gerwitz 1b4ebc13e3 Add notices and DEVNOTES flag
* .gitignore (/config.*): Restrict to root.
* configure.ac (DEVNOTES): Add variable.
  (--enable-devnotes): Add configuration flag.
* doc/Makefile.am (liza_TEXINFOS): config.texi dependency.
* doc/config.texi.in: Add configuration file.
* doc/liza.css: Styling for notices.
* doc/liza.texi: Include configuration.  Add notice for DEVNOTES.
* doc/macros.texi: Add notice macros.
* doc/.gitignore (config.texi): Ignore generated file.
2017-03-23 12:16:52 -04:00
Mike Gerwitz 00e2389a5f macros.texi (helpwanted): Add macro 2017-03-23 12:16:52 -04:00
Mike Gerwitz 9403a1d29b liza.texi: Set document character encoding to UTF-8 2017-03-23 12:16:52 -04:00
Mike Gerwitz 05e22b2309 Add manual HTML styling
This uses GNU Octave's CSS, which formats it like a printed manual
using a modern style.  It's certainly an opinionated style, but at the
very least, the width is important.

* Makefile.am (MAKEINFOHTML): Include CSS reference.
* liza.css: Add stylesheet.
2017-03-23 12:16:52 -04:00
Mike Gerwitz 0c496299a0 design.texi: Add initial component descriptions 2017-03-23 12:16:52 -04:00
Mike Gerwitz 09c32e4792 doc/liza.texi: Include version.texi before reference of VERSION 2017-03-23 12:16:52 -04:00
Mike Gerwitz d432985c67 Added placeholder files for Texinfo documentation
Texinfo is the documenation format of the GNU operating system and can
produce output in a variety of useful formats, including info, HTML, and
PDF.

The HTML output is of particular importance here, since Liza is a JavaScript
framework.
2014-01-16 23:35:45 -05:00