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
|
//
//## Copyright (C) 1998-2003 Joao Cardoso.
//##
//## This program is free software; you can redistribute it and/or modify it
//## under the terms of the GNU General Public License as published by the
//## Free Software Foundation; either version 2 of the License, or (at your
//## option) any later version.
//##
//## This program is distributed in the hope that it will be useful, but
//## WITHOUT ANY WARRANTY; without even the implied warranty of
//## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
//## General Public License for more details.
//##
//## This file is part of plplot_octave.
//
//
// Add online help to functions, parsing 'tmp_stub' and looking for
// function definitions; for each function found, scans directory
// 'plplot_octave_txt' for a file with the same basename as function
// and extension '.txt'; if found, incorporates it as the function
// online help, else, looks in 'plplot.doc' for a one-line description
// of the function and adds it. If not even found in 'plplot.doc', ask
// the user to write the docs! No free lunches!
//
#include "stdio.h"
#include "string.h"
#include "stdlib.h"
#include <sys/stat.h>
#include "errno.h"
int
main()
{
char *p1, *p2;
char doc[150][1024], b[1024], tok[80];
int item = 0, j;
FILE *fp, *fp1;
struct stat buf;
if ( ( fp = fopen( "plplot_octave_txt/plplot.doc", "r" ) ) == NULL )
{
perror( "plplot.doc not found:" );
exit( 1 );
}
while ( !feof( fp ) && fgets( b, sizeof ( b ), fp ) != NULL )
{
if ( strchr( b, '-' ) )
strcpy( doc[item++], b );
}
fclose( fp );
if ( ( fp = fopen( "tmp_stub", "r" ) ) == NULL )
{
perror( "tmp_stub not found:" );
exit( 1 );
}
while ( !feof( fp ) && fgets( b, sizeof ( b ), fp ) != NULL )
{
if ( ( p2 = strchr( b, '(' ) ) ) // function ... = ...(
{
p1 = p2;
while ( *p1-- != ' ' )
;
p1 += 2;
if ( *( p1 + 1 ) == '_' ) // c_...
p1 += 2;
strncpy( tok, p1, p2 - p1 );
*( tok + (int) ( p2 - p1 ) ) = '\0';
printf( "%s", b );
if ( fgets( b, sizeof ( b ), fp ) == NULL )
{
fprintf( stderr, "Error reading line\n" );
return 1;
}
printf( "%s%%\n", b ); // % function ... = ...(
sprintf( b, "plplot_octave_txt/%s.txt", tok );
if ( stat( b, &buf ) && errno == ENOENT )
{
fprintf( stderr, "%s not found, trying plplot.doc... ", b );
strcat( tok, "\t" );
for ( j = 0; j < item; j++ )
{
if ( strncmp( doc[j], tok, strlen( tok ) ) == 0 )
{
printf( "%% %s", &doc[j][strlen( tok ) + 4] ); // strip func --
break;
}
}
if ( j == item )
{
fprintf( stderr, "%s not found\n", tok );
printf( "%% No online help available. Help me, write and submit the documentation, or at least write a one line descriptive text.\n" );
}
else
fprintf( stderr, "%s OK\n", tok );
}
else
{
printf( "%% Original PLplot call documentation:\n%%\n" );
fp1 = fopen( b, "r" );
while ( !feof( fp1 ) && fgets( b, sizeof ( b ), fp1 ) != NULL )
{
printf( "%% %s", b );
}
fclose( fp1 );
}
if ( fgets( b, sizeof ( b ), fp ) == NULL ) // % No doc...
{
fprintf( stderr, "Error reading line\n" );
return 1;
}
if ( fgets( b, sizeof ( b ), fp ) == NULL )
{
fprintf( stderr, "Error reading line\n" );
return 1;
}
printf( "%s", b ); // plplot_oct...
if ( fgets( b, sizeof ( b ), fp ) == NULL )
{
fprintf( stderr, "Error reading line\n" );
return 1;
}
printf( "%s\n", b ); // endfunction
}
}
fclose( fp );
exit( 0 );
}
|
