Article 1521 of alt.galactic-guide: Path: news1.oakland.edu!cs.uiuc.edu!vixen.cso.uiuc.edu!howland.reston.ans.net!usenet.ins.cwru.edu!fishmonger.nouucp!sdh From: sdh@fishmonger.nouucp (Scott D. Heavner) Newsgroups: alt.galactic-guide Subject: The Unix guide, minimal patch and user's guide. Date: Tue, 9 Nov 1993 18:45:15 GMT Organization: (Fishmonger: soon to be a uucp site -- flames to sdh@po.cwru.edu) Lines: 216 Message-ID: Reply-To: sdh@po.cwru.edu NNTP-Posting-Host: nimue.mae.cwru.edu X-Newsreader: TIN [version 1.2 PL2] Well, yesterday I finally got around to trying the guide, but the unix guide is kind of a mess. First I tried the alpha version, but had no clue what it was doing, so I dropped back down to the non-alpha version (0.22) and that didn't work either. Actually, it almost worked, but some of the guide archives on vela have a sub-standard format, comment lines beginning with * or ; within the usual range of %* entries. So rather than fix the entries, I fixed the parser. I also wrote a readme which I think will be useful, rather than the texinfo document which almost always says, "This section has yet to be written." Whoever is in charge of vela can stick this somewhere. I would just save the lines below to a file called tug-nonalpha-patch1 or something. The patch isn't terribly useful, but it will make installation much easier, the README.using is essential for the beginning user (possibly even for advanced users -- I still may have overlooked some of the features of tug). Scott sdh@po.cwru.edu ---- Cut Here -------------------------------- diff -c -N --recursive tug.original/ChangeLog tug/ChangeLog *** tug.original/ChangeLog Tue Jun 16 16:54:49 1992 --- tug/ChangeLog Tue Nov 9 12:17:28 1993 *************** *** 1,3 **** --- 1,21 ---- + Tue Nov 09 09:00:00 1993 Scott Heavner (sdh@po.cwru.edu) + + * Version 0.22.1 + + Adapted tug.c to parse all *.NEW files available on + vela.acs.oakland.edu. This required the addition of + comment delimiters, `*' and `;'. Any line beginning with + one of these two characters will be ignored, with the exception + of a line `*EOA*' which can be used to separate entries. + An entry cannot end with a comment line, it can be terminated + by `*EOA*' or any line which does not begin with a `*', `;', + or `%'. + + Also added `+'/`-' keys for next/previous page. + (Also `_'/`=' which are the shifted and unshifted counterparts + to `+'/`-' on an American keyboard). Also wrote a decent + README -> README.using. + Tue Jun 16 20:53:59 1992 `Grave' Dave Gymer (dpg@florence) * Version 0.22 diff -c -N --recursive tug.original/README.using tug/README.using *** tug.original/README.using --- tug/README.using Tue Nov 9 12:25:46 1993 *************** *** 0 **** --- 1,54 ---- + How to actually use this version of the guide: + + 1) Compile it -- change the makefile to point + DEFAULT_GUIDE to the file which will + ultimately house the guide. + + 2) Install it, by hand or change prefix, + bindir, and infodir in the Makefile. + + 3) get some guide entries: the *.NEW + files on vela.acs.oakland.edu + + 4) start the guide, "tug". Valid options are + -version (list the version number) and + -guide=FILE, set the guide to use FILE + as the default guide rather than the compiled + in option: DEFAULT_GUIDE. + + 5) use the update command "u" to add new + entries. (Other commands are listed below). + + 6) quit and the guide will be updated or + play around a little. + + + MOVING/SCROLLING: + view next entry: n + view previous entry: p + scroll down 1 screen: SPACE, +, = + scroll back 1 screen: BACKSPACE, -, _ + + delete entry: d + add new entries from + a file (update): u + index: i + quit: q + + SEARCHING: + view entry by full name: e + view entry by index: # + view entry by cross-reference: x + + When entering search keys for view command, TAB will list + possible completions and perform the completion for you. (You + must type enough characters to distinguish between possible + completions, the first time you hit tab, it will complete the + word up to the point where it has more than 1 completion, the + second time you hit tab, it will list the completions. Now type + a few characters and hit tab again.) This is especially useful + for cross-references as it will only list the cross-references + for the current entry. + + + diff -c -N --recursive tug.original/tug.c tug/tug.c *** tug.original/tug.c Tue Jun 16 16:54:48 1992 --- tug/tug.c Tue Nov 9 12:27:59 1993 *************** *** 14,20 **** FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. */ ! /* $Id: update.log.65,v 1.1.1.1 2002/05/09 10:29:09 pgg Exp $ */ #define TRACE message(0,"TRACE",__FILE__":%d",__LINE__) --- 14,21 ---- FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. */ ! /* RCS is gone: This is version 0.22.1 1993/11/09 (sdh@po.cwru.edu) */ ! /* $*Id: tug.c,v 0.22 1992/06/16 20:50:36 dpg Alpha dpg $ */ #define TRACE message(0,"TRACE",__FILE__":%d",__LINE__) *************** *** 629,637 **** switch (format_char (s)) { case '\0': ! done = 1; ! if (!entry->text) ! read_entry_text (fp, &entry->text, s); break; case 'a': set_string (&entry->author, str); --- 630,645 ---- switch (format_char (s)) { case '\0': ! /* This is so stupid, what is the point of format string if I ! * re-parse it here? Since `*' and `;' are used as comments in ! * files included from vela.acs.oakland.edu, possibly they are ! * standard. Nahh :) ! */ ! if ( ((s[0] != '*')&&(s[0] != ';'))||(!strcmp(s,"*EOA*")) ) { ! done = 1; ! if (!entry->text) ! read_entry_text (fp, &entry->text, s); ! } break; case 'a': set_string (&entry->author, str); *************** *** 667,672 **** --- 675,684 ---- break; case 'n': set_string (&entry->id, str); + /* If you want to find an entry that is giving you trouble, run tug + * and redirect standard error to a file. And uncomment the next line. + */ + /* fprintf(stderr, "ID: %s\n\n",str); */ break; case 's': set_string (&entry->summary, str); *************** *** 1366,1371 **** --- 1378,1385 ---- { case '\b': case 0x7f: + case '-': + case '_': current_number -= height - 1; refresh = 1; break; *************** *** 1374,1379 **** --- 1388,1395 ---- refresh = 1; break; case ' ': + case '+': + case '=': if (!at_end_of_text) { current_number += height - 1; *************** *** 1598,1604 **** break; case 'v': /* Print version number and exit. */ ! fprintf (stderr, "%s: $Revision: 1.1.1.1 $\n", program_name); return 0; default: usage (); --- 1614,1620 ---- break; case 'v': /* Print version number and exit. */ ! fprintf (stderr, "%s: Version 0.22.1 1993/11/09 (sdh@po.cwru.edu)\n", program_name); return 0; default: usage (); ---- Cut Here --------------------------------