"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. */