1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
|
"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. */
|
