Metanorma AsciiRFC sample: The Holy Hand Grenade of Antioch

Working with the sample

Requirements

You will need Ruby, xml2rfc and idnits (for submission preflight) installed.

On macOS:

brew install idnits
brew install python
easy_install pip
pip install -r requirements.txt
gem install bundler
bundle install

Building

make all

Alternatively:

export ID_NAME=camelot-holy-grenade
make draft-${ID_NAME}.txt

Validating with `idnits`

idnits is the tool for checking RFCs prior to submission.

export ID_NAME=camelot-holy-grenade
make draft-${ID_NAME}.nits

Note

The Makefile target infers the document name from the :name: document attribute and puts the file in the right place before calling idnits to prevent it complaining about the location.

Iterating on your document

export ID_NAME=camelot-holy-grenade
make clean all; open draft-${ID_NAME}.txt