That sounds like the answer then! Well found Nadezhda.
Regards,
Tim
Morozova, Nadezhda wrote:
> My two cents and food for programmer's thought:
>
> 1. Doxygen can get the version from a versioning system. Quote from
> manual:
> The FILE_VERSION_FILTER tag can be used to specify a program or script
> that doxygen should invoke to get the current version for each file
> (typically from the version control system). Doxygen will invoke the
> program by executing (via popen()) the command command input-file, where
> command is the value of the FILE_VERSION_FILTER tag, and input-file is
> the name of an input file provided by doxygen. Whatever the program
> writes to standard output is used as the file version.
> Example of using a shell script as a filter for Unix:
>
> FILE_VERSION_FILTER = "/bin/sh versionfilter.sh"
>
> Example shell script for Subversion:
>
> #!/bin/sh
> svn stat -v $1 | sed -n 's/^[ A-Z?\*|!]\{1,15\}/r/;s/ \{1,15\}/\/r/;s/
> .*//p'
>
> 2. Doxygen can process a custom header/footer to display the info you
> need. Quote from manual:
> HTML_FOOTER
> The HTML_FOOTER tag can be used to specify a user-defined HTML footer
> for each generated HTML page. To get valid HTML the footer file should
> contain at least a </BODY> and a </HTML> tag. The following commands
> have a special meaning inside the footer: $title, $datetime, $date,
> $doxygenversion, $projectname, $projectnumber. Doxygen will replace them
> by respectively the title of the page, the current date and time, only
> the current date, the version number of doxygen, the project name (see
> PROJECT_NAME), or the project number (see PROJECT_NUMBER).
>
>
> Thank you,
> Nadya Morozova
>
>
> -----Original Message-----
> From: Geir Magnusson Jr. [mailto:[EMAIL PROTECTED]
> Sent: Thursday, November 02, 2006 4:59 PM
> To: harmony-dev@incubator.apache.org
> Subject: Re: [classlib][portlib] Docs?
>
>
>
> Paulex Yang wrote:
>> Geir Magnusson Jr. wrote:
>>>
>>> Paulex Yang wrote:
>>>> Geir Magnusson Jr. wrote:
>>>>> yeah - someone generate, and we can hang them on the website. I'm
>>>>> not sure we'd want to check them in though...
>>>> Is it possible to add documents into website but not to commit them
>>>> in SVN?
>>> Yep. I was thinking the same for the Doxygen docs.
>>>
>>> Basically, you just create locally, review, and then tar and put up
> on
>>> site manually.
>> +1 to go for that
>>> It does remove the ability for group oversight (IOW, no commit msgs),
>
>>> but if the generation process isn't very stale (small changes to one
>>> page have repercussions all over...) then it keeps the SVN churn to a
>
>>> minimum.
>> Actually I have no idea what kind of commit msgs needed for API
>> document...they are just generated by tools from codes. I think the
> most
>> important information is the svn revision number against which the
>> document is generated, any doxygen guru can help to find a way? Any
>> chance to pass a revision number to doxygen and to get it added into
>> footer of every page?
>
> That's a very smart idea. +1
>
> geir
>
>>> geir
>>>
>>>
>>> We removed them from classlib/trunk/doc because the SVN metadata
>>>> get in the way when updating the document.
>>>>> I've done this before for API docs...
>>>>>
>>>>> geir
>>>>>
>>>>>
>>>>> Alexey Petrenko wrote:
>>>>>> Having these docs on website will be really good!
>>>>>>
>>>>>> SY, Alexey
>>>>>>
>>>>>> 2006/11/1, Paulex Yang <[EMAIL PROTECTED]>:
>>>>>>> If you get Doxygen installed, you can create it by running "ant
>>>>>>> doxygen-natives" in classlib/trunk/doc. There were discussions to
>
>>>>>>> move
>>>>>>> the document to somewhere on website, but seems it is still to be
>
>>>>>>> done.
>>>>>>>
>>>>>>> Morozova, Nadezhda wrote:
>>>>>>>> Not that I know of :( bits of things are in the devguide,
> maybe.
>>>>>>> But you
>>>>>>>> probably won't find that of much notice.
>>>>>>>> Anyone, please tell me it's not true!
>>>>>>>>
>>>>>>>> Thank you,
>>>>>>>> Nadya Morozova
>>>>>>>>
>>>>>>>>
>>>>>>>> -----Original Message-----
>>>>>>>> From: Alexey Petrenko [mailto:[EMAIL PROTECTED]
>>>>>>>> Sent: Wednesday, November 01, 2006 4:15 PM
>>>>>>>> To: harmony-dev@incubator.apache.org
>>>>>>>> Subject: [classlib][portlib] Docs?
>>>>>>>>
>>>>>>>> Guys,
>>>>>>>>
>>>>>>>> do we have any docs on portlib?
>>>>>>>>
>>>>>>>> SY, Alexey
>>>>>>>>
>>>>>>>>
>>>>>>>
>>>>>>> --
>>>>>>> Paulex Yang
>>>>>>> China Software Development Lab
>>>>>>> IBM
>>>>>>>
>>>>>>>
>>>>>>>
>>>>
>>
>
--
Tim Ellison ([EMAIL PROTECTED])
IBM Java technology centre, UK.
