8. Man pages and supporting programs

8.1. in3multipass

Name

in3multipass A multi-pass parser for in input files

Synopsis

in3multipass [options] [files]

Options

Option
arg
Meaning
Example

 --
use stdin as input file

 -d
 --debug
level
Set debug options

 in3multipass -d 64
 in3multipass --debug 512
 in3multipass --debug=1023

 -c
 --chapter
chapter
Set initial chapter number

 in3multipass -c 3
 in3multipass --chapter 3
 in3multipass --chapter=3

 -i
 --interpret
style
Set interpretation style

 in3multipass -i 2

 -t
 --trace
Provide trace information

 in3multipass -t

 -m
 --markdown
Use mark-down

 in3multipass -m

 --meta.*
meta file
Add meta-file

 in3multipass --metaextras.in

 -+h
Help text

8.2. mkinheader

Name

mkinheader make header/index file for in3

Synposis

mkinheader [ flags ]

Flags

--help
This help
--header -h
create an includable header
--index -i
create an index-file
-t
Don't include the total or complete
-v
increase verbosity

Description

mkinheader creates an index file for all the .in files in the directory. The index file is either in HTML format, without headers ( -h ) or in in3 format ( -i ).

8.3. in3xmlmerge

Name

in3xmlmerge a simple mail-merge for XML files

Synopsis

in3xmlmerge

Description

in3xmlmerge provides a simple mail-merge for in3. In the directory merge all the output files are placed.

For each .in file, in3xmlmerge will check if a .csv file exists, and if so, will create a document set for each line in the .csv file. The .csv is a simple semi-colon (;) separated file and the first line contains the names of the fields. An examle of such a .csv would be

file;name;address;city;code;telephone
james;James T. Kirk;5543 Aliquet St.;Fort Dodge GA;20783;(717) 450-4729
paul;Paul Verlaine;5037 Diam Rd.;Daly City;Ohio 90255;(453) 391-4650
fjodor;Fjodor Dostojewski;6351 Fringilla Avenue;Gardena Colorado ;7547;(559) 104-5475

A sample text would then be:


 
 .merge name
 .br
 .merge address
 .br
 .merge city
 .merge code
 .br
 
 
 Dear
 .merge name
 .br
 I think your phone number is
 .merge telephone
 .br
 Yours,
 .br
 Me
 

The column file is used as the stem for the file. So, for Verlaine, the files would be paul.xml, paul.pdf, paul.html and so on.