]> mj.ucw.cz Git - libucw.git/commitdiff
Doc. system: use @function() for function links
authorMichal Vaner <vorner@ucw.cz>
Sun, 14 Sep 2008 13:37:33 +0000 (15:37 +0200)
committerMichal Vaner <vorner@ucw.cz>
Sun, 14 Sep 2008 13:37:33 +0000 (15:37 +0200)
<<function()>> works too, this is just replacement of the old implicit
function(), which caused problems (the system wanted to put the links
everywhere).

Removed some hacks around the old problems, which are no longer needed.

build/asciidoc-xhtml.conf
build/asciidoc.conf
build/doc-defs

index 8eba6d28674618666e2924230dce4c6968a3deb2..ce7352f39826b78ab6d9619f6eb050eb35739675 100644 (file)
@@ -1,17 +1,11 @@
 [replacements]
 NULL=<tt>NULL</tt>
 
-[macros]
-(?su)[\\]?(?P<name>\w+):!:(?P<rest>\([^();:]*\))=func_no_reuse
-
-[func_param-inlinemacro]
-<i><tt>{name}</tt></i>
-
 [func_ref-inlinemacro]
-<a href='#fun_{name}'>{caption=<tt>{name}:!:{params}</tt>}</a>
+<a href='#fun_{name}'>{caption={all}}</a>
 
 [func_ref_file-inlinemacro]
-<a href='{filename}.html#fun_{name}'>{caption=<tt>{name}:!:{params}</tt>}</a>
+<a href='{filename}.html#fun_{name}'>{caption={all}}</a>
 
 [xref_file-inlinemacro]
 <a href='{filename}.html#{target}'>{caption=[{target}]}</a>
@@ -19,11 +13,11 @@ NULL=<tt>NULL</tt>
 [xref_file_only-inlinemacro]
 <a href='{filename}.html'>{caption=<tt>[{filename}]</tt>}</a>
 
-[func_anchor-inlinemacro]
-<div class="literalblock"><div class="content"><pre><tt>{prefix}:!:{params}</tt></pre></div></div>
-
 [func_auto_ref-inlinemacro]
-<a href='#fun_{name}'><tt>{all}</tt></a>
+<a href='#fun_{name}'>{all}</a>
+
+[func_param-inlinemacro]
+<i><tt>{name}</tt></i>
 
-[func_no_reuse-inlinemacro]
-{name}{rest}
+[func_format-inlinemacro]
+<tt>{all}</tt>
index 8e9af77de8c53282a3b8ff98b6c6f7411a21d3c5..18c92d44f63f7dcab6f53c2e5a880c6bd85ca95f 100644 (file)
@@ -1,13 +1,12 @@
 [macros]
-(?su)[\\]?&lt;&lt;(?P<filename>[^&;:()]+):(?P<name>[^&;:()<> ]+)(?P<params>\([^&:;]*\);?)(,(?P<caption>[^&]+))?&gt;&gt;=func_ref_file
-(?su)[\\]?&lt;&lt;(?P<name>[^&;:()<> ]+)(?P<params>\([^&:;]*\);?)(,(?P<caption>[^&]+))?&gt;&gt;=func_ref
+(?su)[\\]?&lt;&lt;(?P<filename>[^&;:()]+):(?P<all>(?P<name>[^&;:()<> ]+)(\([^&:;]*\);?))(,(?P<caption>[^&]+))?&gt;&gt;=func_ref_file
+(?su)[\\]?&lt;&lt;(?P<all>(?P<name>[^&;:()<> ]+)(\([^&:;]*\);?))(,(?P<caption>[^&]+))?&gt;&gt;=func_ref
 (?su)[\\]?&lt;&lt;(?P<filename>[^&;:()]+):(,(?P<caption>[^&]+))?&gt;&gt;=xref_file_only
 (?su)[\\]?&lt;&lt;(?P<filename>[^&;:()]+):(?P<target>[^,();&]+)(,(?P<caption>[^&]+))?&gt;&gt;=xref_file
+(?su)[\\]?@(?P<all>(?P<name>\w+)\([^();:]*\))=func_ref
+(?su)[\\]?(?P<all>\w+\([^();:]*\))=func_format
 (?su)[\\]?@(?P<word>\w+)@=no_func_param
 (?su)[\\]?@(?P<name>\w+)=func_param
-(?su)[\\]?!!f!(?P<prefix>[^!]*?(?P<name>\w+))(?P<params>\([^&;:()]*\);?)[^!]*!!!=func_anchor
-(?su)[\\]?(?P<all>(?P<name>\w+)\([^();:]*\))=func_auto_ref
-(?su)[\\]?!!PARENT_OPEN!!=parent_open_hack
 (?su)[\\]?@!!KEEP!!(?P<word>\w+)!!KEEP!!@=no_func_param_return
 
 [no_func_param-inlinemacro]
@@ -15,6 +14,3 @@
 
 [no_func_param_return-inlinemacro]
 @{word}@
-
-[parent_open_hack-inlinemacro]
-(
index 1a5b3d138d044198ae9146c6a537e2727b28586d..b0c5a5e8810d5f2c3da8a7f3654be0ae470b50b2 100755 (executable)
@@ -56,7 +56,6 @@ foreach( sort { ( $groups{$a->[2]} <=> $groups{$b->[2]} ) or ( $a->[3] cmp $b->[
        $file = $dircp."/".$file;
        $file =~ s/^\///;
        $file =~ s/\.[^.]+$//;
-       $text =~ s/\(/!!PARENT_OPEN!!/g;
        $text =~ s/(\.\.\.)/\\$1/g;
        print OUT "<<$file:$anchor,`$name`>>:: `$text`\n";
 }