gen_manual.cpp File Reference

#include <iostream>
#include <fstream>
#include <sstream>
#include <vector>

Go to the source code of this file.

Functions
void	trim (string &s, string characters)
void	trim_comments (string &s)
vector< string >	get_lines (vector< string > &input, int &linenum, string terminator)
void	print_line (stringstream &sout, string line)
int	main (int argc, char *argv[])

Function Documentation

get_lines()

vector<string> get_lines	(	vector< string > &	input,
		int &	linenum,
		string	terminator
	)

Definition at line 66 of file gen_manual.cpp.

{
    vector<string> out;
    string line;
 
    while ((size_t)linenum < input.size()) {
        line = input[linenum];
 
        if (terminator.empty() && line.empty()) { linenum--; break; }
 
        size_t const epos = line.find(terminator);
        if (!terminator.empty() && epos!=string::npos) {
            out.push_back(line);
            break;
        }
        out.push_back(line);
        linenum++;
    }
    return out;
}

References input(), setup::line, and out.

Referenced by main().

main()

int main	(	int	argc,
		char *	argv[]
	)

Definition at line 106 of file gen_manual.cpp.

                                 {
    char exclam;
    int linenum, chapter = 1;
    vector<string> input, lines, comments, chapters;
    string line, version;
    size_t spos, l;
    stringstream sout;
    ifstream istream;
    ofstream ostream;
 
    if (argc < 4) {
        cout << "usage: " << argv[0] << " [lz4_version] [input_file] [output_html]" << endl;
        return 1;
    }
 
    version = string(argv[1]) + " Manual";
 
    istream.open(argv[2], ifstream::in);
    if (!istream.is_open()) {
        cout << "Error opening file " << argv[2] << endl;
        return 1;
    }
 
    ostream.open(argv[3], ifstream::out);
    if (!ostream.is_open()) {
        cout << "Error opening file " << argv[3] << endl;
        return 1;
   }
 
    while (getline(istream, line)) {
        input.push_back(line);
    }
 
    for (linenum=0; (size_t)linenum < input.size(); linenum++) {
        line = input[linenum];
 
        /* typedefs are detected and included even if uncommented */
        if (line.substr(0,7) == "typedef" && line.find("{")!=string::npos) {
            lines = get_lines(input, linenum, "}");
            sout << "<pre><b>";
            for (l=0; l<lines.size(); l++) {
                print_line(sout, lines[l]);
            }
            sout << "</b></pre><BR>" << endl;
            continue;
        }
 
        /* comments of type  / * * < and  / * ! <  are detected, and only function declaration is highlighted (bold) */
        if ((line.find("/**<")!=string::npos || line.find("/*!<")!=string::npos)
          && line.find("*/")!=string::npos) {
            sout << "<pre><b>";
            print_line(sout, line);
            sout << "</b></pre><BR>" << endl;
            continue;
        }
 
        spos = line.find("/**=");
        if (spos==string::npos) {
            spos = line.find("/*!");
            if (spos==string::npos)
                spos = line.find("/**");
            if (spos==string::npos)
                spos = line.find("/*-");
            if (spos==string::npos)
                spos = line.find("/*=");
            if (spos==string::npos)
                continue;
            exclam = line[spos+2];
        }
        else exclam = '=';
 
        comments = get_lines(input, linenum, "*/");
        if (!comments.empty()) comments[0] = line.substr(spos+3);
        if (!comments.empty())
            comments[comments.size()-1] = comments[comments.size()-1].substr(0, comments[comments.size()-1].find("*/"));
        for (l=0; l<comments.size(); l++) {
            if (comments[l].compare(0, 2, " *") == 0)
                comments[l] = comments[l].substr(2);
            else if (comments[l].compare(0, 3, "  *") == 0)
                comments[l] = comments[l].substr(3);
            trim(comments[l], "*-=");
        }
        while (!comments.empty() && comments[comments.size()-1].empty()) comments.pop_back(); // remove empty line at the end
        while (!comments.empty() && comments[0].empty()) comments.erase(comments.begin()); // remove empty line at the start
 
        /* comments of type  / * !  mean: this is a function declaration; switch comments with declarations */
        if (exclam == '!') {
            if (!comments.empty()) comments.erase(comments.begin()); /* remove first line like "LZ4_XXX() :" */
            linenum++;
            lines = get_lines(input, linenum, "");
 
            sout << "<pre><b>";
            for (l=0; l<lines.size(); l++) {
                print_line(sout, lines[l]);
            }
            sout << "</b><p>";
            for (l=0; l<comments.size(); l++) {
                print_line(sout, comments[l]);
            }
            sout << "</p></pre><BR>" << endl << endl;
        } else if (exclam == '=') { /* comments of type  / * =  and  / * * =  mean: use a <H3> header and show also all functions until first empty line */
            trim(comments[0], " ");
            sout << "<h3>" << comments[0] << "</h3><pre>";
            for (l=1; l<comments.size(); l++) {
                print_line(sout, comments[l]);
            }
            sout << "</pre><b><pre>";
            lines = get_lines(input, ++linenum, "");
            for (l=0; l<lines.size(); l++) {
                print_line(sout, lines[l]);
            }
            sout << "</pre></b><BR>" << endl;
        } else { /* comments of type  / * *  and  / * -  mean: this is a comment; use a <H2> header for the first line */
            if (comments.empty()) continue;
 
            trim(comments[0], " ");
            sout << "<a name=\"Chapter" << chapter << "\"></a><h2>" << comments[0] << "</h2><pre>";
            chapters.push_back(comments[0]);
            chapter++;
 
            for (l=1; l<comments.size(); l++) {
                print_line(sout, comments[l]);
            }
            if (comments.size() > 1)
                sout << "<BR></pre>" << endl << endl;
            else
                sout << "</pre>" << endl << endl;
        }
    }
 
    ostream << "<html>\n<head>\n<meta http-equiv=\"Content-Type\" content=\"text/html; charset=ISO-8859-1\">\n<title>" << version << "</title>\n</head>\n<body>" << endl;
    ostream << "<h1>" << version << "</h1>\n";
 
    ostream << "<hr>\n<a name=\"Contents\"></a><h2>Contents</h2>\n<ol>\n";
    for (size_t i=0; i<chapters.size(); i++)
        ostream << "<li><a href=\"#Chapter" << i+1 << "\">" << chapters[i].c_str() << "</a></li>\n";
    ostream << "</ol>\n<hr>\n";
 
    ostream << sout.str();
    ostream << "</html>" << endl << "</body>" << endl;
 
    return 0;
}

References argv, compare(), get_lines(), i, in, input(), setup::line, lines(), out, print_line(), trim(), and version.

print_line()

void print_line	(	stringstream &	sout,
		string	line
	)

Definition at line 89 of file gen_manual.cpp.

{
    size_t spos, epos;
 
    if (line.substr(0,11) == "LZ4LIB_API ") line = line.substr(11);
    if (line.substr(0,12) == "LZ4FLIB_API ") line = line.substr(12);
    spos = line.find("/*");
    epos = line.find("*/");
    if (spos!=string::npos && epos!=string::npos) {
        sout << line.substr(0, spos);
        sout << "</b>" << line.substr(spos) << "<b>" << '\n';
    } else {
        sout << line << '\n';
    }
}

References setup::line.

Referenced by main().

trim()

void trim	(	string &	s,
		string	characters
	)

Definition at line 43 of file gen_manual.cpp.

{
    size_t p = s.find_first_not_of(characters);
    s.erase(0, p);
 
    p = s.find_last_not_of(characters);
    if (string::npos != p)
       s.erase(p+1);
}

References p, and s.

Referenced by main(), rz_core_cmd_subst_i(), rz_str_split_duplist(), rz_str_split_duplist_n(), rz_str_split_duplist_n_regex(), str_split_list_common(), and str_split_list_common_regex().

trim_comments()

void trim_comments

(

string &

s

)

Definition at line 55 of file gen_manual.cpp.

{
    size_t spos, epos;
 
    spos = s.find("/*");
    epos = s.find("*/");
    s = s.substr(spos+3, epos-(spos+3));
}

References s.