diff options
Diffstat (limited to 'nx-X11/extras/rman/contrib/sutter.txt')
-rw-r--r-- | nx-X11/extras/rman/contrib/sutter.txt | 155 |
1 files changed, 0 insertions, 155 deletions
diff --git a/nx-X11/extras/rman/contrib/sutter.txt b/nx-X11/extras/rman/contrib/sutter.txt deleted file mode 100644 index b467bb348..000000000 --- a/nx-X11/extras/rman/contrib/sutter.txt +++ /dev/null @@ -1,155 +0,0 @@ -"Edward L. Sutter" <els@sage.sage.att.com> - -Perhaps there is already a better way to do this, but since I couldn'd find -one, I'd like to make a suggestion that has helped me quite a bit for getting -the proper hypertext links. Keep in mind that this is under the context of -me converting "man" directories with their typical sub-directories of -man1, man2, etc... to an equivalently structured "html" directory with -the same sub-directory heirarchy. - -I added an option to rman that allows it to search for the files over -a specified set of directories. This allows (for example) manpages under -man1 that reference something under man3 to be properly linked. - -rman.c v2.4 ... - -... - -/* ELS: added to support a smarter external reference generator. */ -char *SearchDirs=0; -int HrefSearch(); - -... - -/* ELS: added the -S option: */ - while ((c=getopt(argc,argv,"Kh?f:l:r:bckmTpvn:t:s:yS:"))!=-1) - switch (c) { - case 'k': fHeadfoot=1; break; - case 'b': fSubsections=1; break; - case 'c': fChangeleft=1; break; - case 'S': SearchDirs=optarg; break; - - -... - - -void -HTML(enum command cmd) { - -... - - - case BEGINMANREF: - for (p=hitxt; *p && *p!='('; p++) /* empty */; - *p++='\0'; p0=p; - for (; *p && *p!=')'; p++) /* empty */; - *p='\0'; -/* ELS: added a call to HrefSearch() if the -S option is set.. */ - if (SearchDirs) - HrefSearch(hitxt,p0); - else { - printf("<A HREF=\""); - printf(manRef, hitxt, p0); - printf("\">"); - } - break; - - -... - - -/* ELS... - HrefSearch(): - Active only with command line option -S... - Called when rman -fHTML has determined that it is going to add a - hypertext link. The user tells rman where to search for the hypertext - links (local machine search only) and if HrefSearch() finds the file - - SRCHDIR/manname.section - - where - SRCHDIR is one of the colon-delimited paths specified with - the -S option; - manname is the text that rman found preceding a "manname(##)" - detection; - section is the string within the parens of the manname spec; - - - then it will use that path to build the HREF line. If not found, - then <A> is all that is inserted. - This is generally only helpful when you are simply attempting to - turn a man directory into an html directory. - - Note that if the first char of SearchDirs is a colon, then if - HrefSearch does not find the reference, it defaults to what rman - used to do (use manRef, -r option); otherwise, it will not add - a hypertext link at all. -*/ -HrefSearch(manname,section) -char *manname, *section; -{ - char *dir, *colon, tmp; - int DefaultToManRef; - FILE *fp; - static char path[256]; - - tmp = 0; - -again: - if (SearchDirs[0] == ':') { - dir = &SearchDirs[1]; - DefaultToManRef = 1; - } - else { - dir = SearchDirs; - DefaultToManRef = 0; - } - - /* Make 2 passes on all search directories... */ - /* First pass is with the path dir/manname.section */ - /* Second pass is with the path dir/manname.section[0] */ - /* This allows the spec manname(3x) to be found as manname.3 */ - /* just in cast manname.3x doesn't exist. */ - /* Note that the second pass is only necessary if the section */ - /* string is more than one character in length. */ - while(1) { - colon = strchr(dir,':'); - if (colon) *colon = 0; - sprintf(path,"%s/%s.%s.html",dir,manname,section); - if ((fp = fopen(path,"rw")) != NULL) { - printf("<A HREF=\""); - printf("%s",path); - printf("\">"); - fclose(fp); - if (colon) *colon = ':'; - fprintf(stderr,"HREF @ %s\n",path); - return(1); - } - if (colon) { - *colon = ':'; - dir = colon+1; - } - else - break; - } - if (section[1]) { - tmp = section[1]; - section[1] = 0; - dir = SearchDirs; - goto again; - } - if (tmp) - section[1] = tmp; - - if (DefaultToManRef) { - printf("<A HREF=\""); - printf(manRef, manname, section); - printf("\">"); - } - else - printf("<A>"); - return(1); -} - -/* End ELS additions. */ - |