1
0
Fork 0
Commit Graph

45 Commits (229a356a9a7d7480d65f48d44f3be4147a51e915)

Author SHA1 Message Date
Mike Gerwitz 18cd46c87b doc/Makefile.am (liza_TEXINFOS): Add missing license.texi 2017-06-29 11:01:23 -04:00
Mike Gerwitz 0c24e3d280 Populate document metadata using Data APIs
What a cluster.

This was a lot of work to work around existing, bad APIs; there is no
time to refactor at the moment; this already took much longer than
expected.
2017-06-28 16:33:24 -04:00
Mike Gerwitz 07b5d2f1b6 doc: Began server documentation
* server.texi: Add file.
2017-06-22 13:07:30 -04:00
Mike Gerwitz c231983f34 doc: Add @jsmethod macro
* doc/macros.texi (@jsmethod): Add macro.
2017-06-21 13:20:56 -04:00
Mike Gerwitz f870ca964c doc: Add @todo
* doc/macros.texi (@todo): Add macro.
2017-06-21 13:20:40 -04:00
Mike Gerwitz 5c99243cdc doc: Add beginning of dapi documentation
* doc/Makefile.am (liza_TEXINFOS) [dapi.texi]: Include file.
* doc/dapi.texi: Add file.
* doc/design.texi: Add mention in list and reference chapter.
* doc/liza.texi: Reference chapter.
2017-06-21 10:52:46 -04:00
Mike Gerwitz be0121d8cb doc: Add @progxmlref, @dapi, @procguic{,x}ref, @proguicrefsuffix
* doc/macros.texi (@progxmlref, @dapi, @progcuicref, @proguicxref
  @proguicrefsuffix): Add macros.
2017-06-21 10:52:46 -04:00
Mike Gerwitz f873da0928 doc: Add @srcrefjs macros
* doc/macros.texi (srcrefjs): Add macros when src is both available and not
2017-06-21 10:52:46 -04:00
Mike Gerwitz 83b5f1ab74 doc: Update @helpwanted text
* doc/macros.texi (helpwanted): Adjust phrasing to account for some existing text.
2017-06-21 10:52:46 -04:00
Mike Gerwitz d2dd963614 doc: Extract design sections into own chapters
* assert.texi, bucket.texi, client.texi, pred.texi, program.texi,
  validation.texi: New files.
* design.texi: Extract text into above.
* liza.texi: Add @menu references and @include each new file.
2017-06-21 10:52:46 -04:00
Mike Gerwitz 6a86564364 Add missing FDL text
...!  No idea how this was missed.

* doc/license.texi: Add file.
* liza.texi: Use it.
2017-06-20 14:17:06 -04:00
Mike Gerwitz 55fccd8b8e Remove mvnotices from docs
Liza has been liberated.

* doc/design.texi: Remove all @mvnotice calls.
* doc/macros.texi (mvnotice): Remove macro.
2017-06-13 00:14:03 -04:00
Mike Gerwitz 1bb5191e3e LoVullo Associates => R-T Specialty
Copyright notices updated.  More casual references to "LoVullo
Associates" replaced with "RT Specialty / Lovullo", which will be "RT
Specialty Buffalo" in the future.  Or "RT Specialty", depending on how
this is rolled out.  Or "Ryan Specialty Group".  Who knows.

"R-T Specialty, LLC." is the legal name, which includes the dash.  Not
to be confused with a certain television network.
2017-06-08 14:48:43 -04:00
Mike Gerwitz 0cf800f5d9 Add event graph diagram
* doc/diagram/event-graph.dot: Add graph.
* doc/diagram/.gitignore: Ignore `*.svg'.
2017-06-08 14:38:32 -04:00
Mike Gerwitz 54d2eff8b9 Add diagram generation with graphviz
* configure.ac (TWOPI, HAS_TWOPI): Add variables.
  Check for towpi.
* doc/.gitignore (diagrams/*.svg): Add output file ignore.
* doc/Makefile.am: Add svg diagram building.
2017-06-08 14:38:32 -04:00
Mike Gerwitz 7c6b884895 doc/design.texi (Group Styles): Put table into float 2017-03-23 12:16:52 -04:00
Mike Gerwitz bff17bdbb6 doc/liza.css: Change font
This imports from Google, which is a privacy risk.  These should be
moved to be hosted locally; their download can be scripted.
2017-03-23 12:16:52 -04:00
Mike Gerwitz f89c311d1d doc/liza.texi: Add predicate system documentation 2017-03-23 12:16:52 -04:00
Mike Gerwitz 5abfedeb54 doc/liza.css: Example block and float styling 2017-03-23 12:16:52 -04:00
Mike Gerwitz b05d48a572 doc/macros.texi (@progxml): Add macro 2017-03-23 12:16:52 -04:00
Mike Gerwitz 8d09c2d8c3 doc/macros.texi: Fix PDF output issues with @maintenance
doc/macros.texi (@maintstart, @maintend): Add macros.
(@maintenance): Use them.
2017-03-23 12:16:52 -04:00
Mike Gerwitz 2ed43ba986 doc/macros.texi (@xmlnode, @xmlattr): Add macros 2017-03-23 12:16:52 -04:00
Mike Gerwitz 637ae01e95 doc/macros.texi (@tip): Add macro
doc/liza.css: Add tip notice styling.
2017-03-23 12:16:52 -04:00
Mike Gerwitz 3dfde49f76 doc/design.texi (Program UI): Add notices
(Client): Add reference to Program UI in notice.
2017-03-23 12:16:52 -04:00
Mike Gerwitz b7adc3b844 doc/macros.texi (@refactornotice): Add macro 2017-03-23 12:16:52 -04:00
Mike Gerwitz 2475cc37a6 doc/macros.texi (@srcrefraw): Add macro
I do not think Texinfo supports optional macro arguments.
2017-03-23 12:16:52 -04:00
Mike Gerwitz a7368d1b52 doc/design.texi (Program): Add matinenance and mv notices 2017-03-23 12:16:52 -04:00
Mike Gerwitz f93539a827 doc/macros.texi (@mvnotice): Add macro 2017-03-23 12:16:52 -04:00
Mike Gerwitz 87fb6277f7 doc/design.texi (Client): Add maintenance concerns 2017-03-23 12:16:52 -04:00
Mike Gerwitz 041cde783a doc/design.texi (Assertions): Add maintenance concerns 2017-03-23 12:16:52 -04:00
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