Mar 01: Michael Sanders demos an X-windows GUI for AWK.
Mar 01: Awk100#24: A. Lahm and E. de Rinaldis' patent search, in AWK
Feb 28: Tim Menzies asks this community to write an AWK cookbook.
Feb 28: Arnold Robbins announces a new debugger for GAWK.
Feb 28: Awk100#23: Premysl Janouch offers a IRC bot, In AWK
Feb 28: Updated: the AWK FAQ
Feb 28: Tim Menzies offers a tiny content management system, in Awk.
Jan 31: Comment system added to awk.info. For example, see discussion bottom of ?keys2awk
Jan 31: Martin Cohen shows that Gawk can handle massively long strings (300 million characters).
Jan 31: The AWK FAQ is being updated. For comments/ corrections/ extensions, please mail email@example.com
Jan 31: Martin Cohen finds Awk on the Android platform.
Jan 31: Aleksey Cheusov released a new version of runawk.
Jan 31: Hirofumi Saito contributes a candidate Awk mascot.
Jan 31: Michael Sanders shows how to quickly build an AWK GUI for windows.
Jan 31: Hyung-Hwan Chung offers QSE, an embeddable Awk Interpreter.
The amazingly workable (text) formatter
awf -macros [ file ] ...
Download from LAWKER. Type "make r" to run a regression test, formatting the manual page (awf.1) and comparing it to a preformatted copy (awf.1.out). Type "make install" to install it. Pathnames may need changing.
Awf formats the text from the input file(s) (standard input if none) in an imitation of nroff's style with the -man or -ms macro packages. The -macro option is mandatory and must be `-man' or `-ms'.
Awf is slow and has many restrictions, but does a decent job on most manual pages and simple -ms documents, and isn't subject to AT&T's brain-damaged licensing that denies many System V users any text formatter at all. It is also a text formatter that is simple enough to be tinkered with, for people who want to experiment.
Awf implements the following raw nroff requests:
.\" .ce .fi .in .ne .pl .sp .ad .de .ft .it .nf .po .ta .bp .ds .ie .ll .nr .ps .ti .br .el .if .na .ns .rs .tm
and the following in-text codes:
\$ \% \* \c \f \n \s
plus the full list of nroff/troff special characters in the original V7 troff manual.
Many restrictions are present; the behavior in general is a subset of nroff's. Of particular note are the following:
White space at the beginning of lines, and imbedded white space within lines, is dealt with properly. Sentence terminators at ends of lines are understood to imply extra space afterward in filled lines. Tabs are implemented crudely and not quite correctly, although in most cases they work as expected. Hyphenation is done only at explicit hyphens, emdashes, and nroff discretionary hyphens.
The -man macro set implements the full V7 manual macros, plus a few semi- random oddballs. The full list is:
.B .DT .IP .P .RE .SM .BI .HP .IR .PD .RI .TH .BR .I .LP .PP .RS .TP .BY .IB .NB .RB .SH .UC
.BY and .NB each take a single string argument (respectively, an indi- cation of authorship and a note about the status of the manual page) and arrange to place it in the page footer.
The -ms macro set is a substantial subset of the V7 manuscript macros. The implemented macros are:
.AB .CD .ID .ND .QP .RS .UL .AE .DA .IP .NH .QS .SH .UX .AI .DE .LD .NL .R .SM .AU .DS .LG .PP .RE .TL .B .I .LP .QE .RP .TP
Size changes are recognized but ignored, as are .RP and .ND. .UL just prints its argument in italics. .DS/.DE does not do a keep, nor do any of the other macros that normally imply keeps.
Assignments to the header/footer string variables are recognized and implemented, but there is otherwise no control over header/footer formatting. The DY string variable is available. The PD, PI, and LL number registers exist and can be changed.
The only output format supported by awf, in its distributed form, is that appropriate to a dumb terminal, using overprinting for italics (via underlining) and bold. The nroff special characters are printed as some vague approximation (it's sometimes very vague) to their correct appearance.
Awf's knowledge of the output device is established by a device file, which is read before the user's input. It is sought in awf's library directory, first as dev.term (where term is the value of the TERM environment variable) and, failing that, as dev.dumb. The device file uses special internal commands to set up resolution, special characters, fonts, etc., and more normal nroff commands to set up page length etc.
All in /usr/lib/awf (this can be overridden by the AWFLIB environment variable):
common common device-independent initialization dev.* device-specific initialization mac.m* macro packages pass1 macro substituter pass2.base central formatter pass2.m* macro-package-specific bits of formatter pass3 line and page composer
awk(1), nroff(1), man(7), ms(7)
Unlike nroff, awf complains whenever it sees unknown commands and macros. All diagnostics (these and some internal ones) appear on standard error at the end of the run.
Written at University of Toronto by Henry Spencer, more or less as a supplement to the C News project.
Copyright 1990 University of Toronto. All rights reserved. Written by Henry Spencer. This software is not subject to any license of the American Telephone and Telegraph Company or of the Regents of the University of California.
Permission is granted to anyone to use this software for any purpose on any computer system, and to alter it and redistribute it freely, subject to the following restrictions:
There are plenty, but what do you expect for a text formatter written entirely in (old) awk?
The -ms stuff has not been checked out very thoroughly.blog comments powered by Disqus