[interchange-docs] Expansion of WellWell tags

Davor Ocelic docelic at spinlocksolutions.com
Wed Mar 10 11:49:54 UTC 2010

On Tue, 09 Mar 2010 14:21:33 +0100
"Stefan Hornburg (Racke)" <racke at linuxia.de> wrote:

> There is no expansion of &tag-xxx; in the WellWell guide for
> tags inside Wellwell, see below:
> http://docs.icdevgroup.org/cgi-bin/online/wellwell/ar01s06.html
> Forms created and submitted via &tag-form; bypass this permission
> check because they are evaluated earlier, during autoload routine.
> How can I fix this?

If you know the exact text and/or link you want to put,
simply edit docbook/literals.net and include something like

<!ENTITY tag-xxx "<tag>xxx</tag>">

(For a full list of existing symbols, see docbook/autorefs.ent.
The literals.ent is a fixed file committed to Git. The
autorefs.ent is auto-generated when 'make cache' runs, by
parsing IC sources in sources/*).

Better yet, you can copy the wellwell tree anywhere into
sources/git-head/, and then the next run of 'make cache' should
discover those (and other symbols) automatically and include
them in the listing and symbols.

It will work just by copying wellwell into the tree with no other
changes necessary, but just as a side note-- in case that it doesn't
pick up some of the symbols, it means you need to simply adjust the
regexes at the top of bin/stattree, in %ascii_types:

For example, there it says:

%ascii_types= (
usertag => [qw|UserTag/\S+\.tag \.tag dist/usertag/|],

The second regex, \.tag, will match any *.tag files no matter
the directory, so in that case you don't have to do anything
to get them recognized. In other situations, adjust accordingly.


More information about the docs mailing list