[prev in list] [next in list] [prev in thread] [next in thread] 

List:       boost-docs
Subject:    Re: [Boost-docs] Generating slightly better filenames
From:       "Daniel James" <daniel_james () fmail ! co ! uk>
Date:       2008-05-08 22:21:13
Message-ID: 31f5f6790805081521k34a7f01m2c860822c03de7a8 () mail ! gmail ! com
[Download RAW message or body]

On 30/04/2008, Daniel James <daniel_james@fmail.co.uk> wrote:
[snip]
>
>  Spaces are converted to underscores, and consecutive underscores are
>  replaced with single underscores. It's a bit of a hack but it seems to
>  work okay.

I've merged this into trunk now.

>  I'll try to make further improvements at some point - such as not
>  including the 'typename' and truncating long type names like this but
>  that will require a better understanding of the xsl so I probably
>  won't get round to it for a while.

It turns out that supporting variadic template parameters in template
specializations needs some improvements here, so I've made a few
changes in the doc branch:

1. There are actually two different templates for generating ids for
functions, so I combined them. The new version uses the function name
if it's unique, otherwise it generates the id and adds the unique
numeric id on the end.

http://svn.boost.org/trac/boost/changeset/45130

2. I changed the id generating templates, so that instead of calling
'fully-qualified-name' they call a new template 'fully-qualified-id'.
This will make it easier to make changes to the generated ids. For a
start it replaces dots that aren't seperators with underscores - this
is needed for template packs. The exisiting code converts the three
dots to three slashes (i.e. directory separators).

http://svn.boost.org/trac/boost/changeset/45131

3. At the moment all members of template specializations have a
numeric id added to the end of its generated id - but the generated id
is often the numeric id anyway, so you end up with something like
'id253720-bb_id253720'. This only adds the numeric id when generating
the id from the full name.

http://svn.boost.org/trac/boost/changeset/45152

I'll merge these changes into trunk soon if there's no objections -
and probably then merge all of this to the release branch.

Daniel
_______________________________________________
Boost-docs mailing list
Boost-docs@lists.boost.org
http://lists.boost.org/mailman/listinfo.cgi/boost-docs
[prev in list] [next in list] [prev in thread] [next in thread]