This program is a cgi-bin script which adds html link markup on the fly to IETF text-format documents - i.e. RFCs, drafts and other text docu‐ ments which contain references to RFCs and drafts.

The script is written in Python, so the http server on which you run it must have Python installed. You can download Python from http://www.python.org. The script has been verified to work with Python 2.2 and later.

It may be called by either http POST or GET, and the relevant field names which may be provided are as follows:

rfc=number

Specify the number of an RFC to fetch and mark up.

draft=draft-name

Specify the name of an internet-draft to fetch and mark up

doc=rfcnum-or-draftname

rfcmarkup will guess which document is wanted based on the name or number given

url=some-general-url

Specify an url to fetch and mark up. If the URL does not have a scheme identifier, or if it has file: as its scheme identifier, this opens a local file; otherwise it opens a socket to a server somewhere on the network.

Either rfc, draft, doc or url must be provided.

Example:

http://www.levkowetz.com/ietf/rfcmarkup?rfc=3344

will return RFC 3344 with added link markup.

repository=repository-path

Specify a nonstandard repository to fetch documents from. By default, RFCs or drafts are read from the repository at http://www.ietf.org/. repository-path may be an url or a path local to the server on which the script is running. The last alternative is useful when running the script under a http server on a local machine, when you also have an RFC and draft repository on the same machine. This option assumes that there is one rfc/ directory and one internet-drafts/ directory under the given repository path, whether it is an url or a local path.

Example:

http://localhost/cgi-bin/rfcmarkup?rfc=3344&repository=/usr/local/share/ietf

will fetch RFCs from /usr/local/share/ietf/rfc/ on the server on which the script is running.

Copyright 2002 Henrik Levkowetz

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MER‐ CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should be able to retrieve a copy of the GNU General Public License from http://www.gnu.org/licenses/gpl.txt; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA