OpenCores
URL https://opencores.org/ocsvn/core_arm/core_arm/trunk

Subversion Repositories core_arm

[/] [core_arm/] [trunk/] [soft/] [doc/] [doc.pl] - Blame information for rev 2

Go to most recent revision | Details | Compare with Previous | View Log

Line No. Rev Author Line
1 2 tarookumic
#!/usr/bin/perl 
2
# Purpose: Generate annotated .html files out of list of .vhdl files
3
# call:
4
# $ doc.pl <filelist-filename>
5
 
6
#$dbgon = 1;
7
 
8
$sp = "[\\s]*";
9
$id = "[a-zA-Z][a-zA-Z0-9_]*";
10
$spid = "[a-zA-Z0-9_]*";
11
 
12
print("Require doc1.pl\n");
13
require "doc1.pl";
14
print("Require doc2.pl\n");
15
require "doc2.pl";
16
print("Require doc3.pl\n");
17
require "doc3.pl";
18
print("Require doc4.pl\n");
19
require "doc4.pl";
20
print("Require doc5.pl\n");
21
require "doc5.pl";
22
print("Require doc6.pl\n");
23
require "doc6.pl";
24
 
25
if ($d3_maintemplate eq "") {
26
    die ("The [main] entry for the main template is missing in the config file\n");
27
}
28
 
29
$body_all = "";
30
print("Read all files\n");
31
$body_all = d3_readallfiles();
32
print("Createusage\n");
33
d3_createusage($body_all);
34
 
35
d2_dumpmasks();
36
d3_dumpfilelist();
37
 
38
print("Scanning for records\n");
39
d2_scanrecords($body_all);
40
print("Scanning for functions\n");
41
d2_scanfuncs($body_all);
42
print("Scanning for procedures\n");
43
d2_scanprocedures($body_all);
44
print("Scanning for constants\n");
45
d2_scanconsts($body_all);
46
print("Scanning for enums\n");
47
d2_scanenums($body_all);
48
print("Scanning for entities\n");
49
d2_scanentities($body_all);
50
print("Scanning for architectures\n");
51
d2_scanarchs($body_all);
52
 
53
d2_dumpscan();
54
 
55
 
56
if (!($d3_header eq "" || $d3_fileselect eq "")) {
57
 
58
    $header = d6_createheader($filename,$d3_header);
59
    $header = d3_template_pathreplace($header,$d3_fileselect);
60
 
61
    if (-e $d3_fileselect) {
62
        `cp $d3_fileselect $d3_fileselect.back`;
63
    }
64
 
65
    open $F,">$d3_fileselect" or die ("Unable to open output $d3_fileselect\n");
66
    print $F $header;
67
    close $F;
68
    print("Save fileselect $d3_fileselect\n");
69
}
70
 
71
if (!($d3_frame eq "" || $d3_framebase eq "")) {
72
 
73
    $d3_header = d3_relpath($d3_framebase,$d3_fileselect);
74
    $d3_frame =~ s/%fileselect%/$d3_header/gi;
75
 
76
    if (-e $d3_framebase) {
77
        `cp $d3_framebase $d3_framebase.back`;
78
    }
79
    open $F,">$d3_framebase" or die ("Unable to open output $d3_framebase\n");
80
    print $F $d3_frame;
81
    close $F;
82
    print("Save index $d3_framebase\n");
83
}
84
 
85
print("Assembling output\n");
86
 
87
@ar = @d3_files;
88
$body = "";
89
$off = 0;
90
$filename;
91
foreach(@ar) {
92
    $filename = $_;
93
 
94
    print ("Processing file $_\n");
95
 
96
    $body = d3_readfile($filename,1);
97
    d1_process($body,$off);
98
    $html = d5_gethtml($off,$off + length($body),"");
99
 
100
    $header = "";
101
 
102
    $html = d5_assemblehtml($filename,$html,$d5_dumphtml_types,$d3_maintemplate,$header);
103
    $html =~ s/(--[^\n]*\n)/<span class="comment">\1<\/span>/g;
104
    $html = d3_template_replace($html);
105
 
106
    if (not ($filename =~ /\.htlm$/)) {
107
        $filename =~ s/\.[a-zA-Z]*?$/\.html/i;
108
 
109
        $html = d3_template_pathreplace($html,$filename);
110
 
111
        if (-e $filename) {
112
            `cp $filename $filename.back`;
113
        }
114
        open $F,">$filename" or die ("Unable to open output $filename\n");
115
        print $F $html;
116
        close $F;
117
        print("Save $filename\n");
118
    }
119
    $d5_dumphtml_types = "";
120
    %d5_dumphtml_types_alloc = ();
121
    $off += length($body);
122
}
123
 
124
#d5_dumpcut();
125
 
126
 

powered by: WebSVN 2.1.0

© copyright 1999-2025 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.