212627 - Add a CVS last-modified date to the documentation

Status: RESOLVED WONTFIX

(Bugzilla :: Documentation, enhancement, P5)

Description

[Ralf Hauser]

User-Agent:       Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US; rv:1.5a) Gecko/20030706
Build Identifier: Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US; rv:1.5a) Gecko/20030706

It is not so easy to find the sources for this and cvs check-outs are tedious
for novices.

Reproducible: Always

Steps to Reproduce:
Also, can docbook be convinced to reflect a CVS "$Date: 2003/07/09 12:03:52 $"
as a last-modified footer/header in each html page it creates?
Actual Results:  
.

Expected Results:  
patch to xml/about.xml:
103c103
<       subtree or you can just look a single files <ulink
url="http://lxr.mozilla.org/mozilla/source/webtools/bugzilla/docs">here</ulink>.
---
>       subtree.

Comment 1

[Dave Miller [:justdave]]

Jake is leaving for a while (Reserve unit got called up), and we don't have a
new docs owner yet.  Anyone interested in helping out, please add
[e-mail] to your watch list in your email preferences in Bugzilla.

Comment 2

[Dave Miller [:justdave]]

Preliminarily moving all docs bugs to 2.18, we should make a valiant attempt to
have the docs as up-to-date as possible when 2.18 releases.

Comment 3

[Dave Miller [:justdave]]

The docbook sources are in every Bugzilla tarball, too.

I'm not sure I follow what this bug is about though...  Ralf?  can you clarify
what you're asking for?

Comment 4

[Jacob Steenhagen]

I'm sure DocBook can be convinced to do this, but I personally find the $Date: $
convention to be quite ugly for a documentation and/or web page. I personally
have no problem using it inside a comment or in code where it can be properly
modified, but other than that, it's ugly :).

On that other part, are you just requesting that more information about where to
find the XLM source be added to the documentation?

Comment 5

[A. Karl Kornel]

Suggest marking INVALID (by comment 3 + lack of followup) or WORKSFORME (by
comment 3 and comment 4).

Comment 6

[Max Kanat-Alexander]

Well, it looks like the docs team doesn't want to do the CVS thing, the other
request is slightly unclear, and this bug contains two or three separate issues.

So, if you can resolve all of those things, feel free to re-open this bug.

Comment 7

[Ralf Hauser]

I agree with Jacob that the CVS default syntax is not particularly nice.
Therefore, sure, it would be great to have a nicely formatted html footer line
that shows the last-modified date.

The "about xml" patch might deserve a separate RFE, it was just to raise the
comfort level and even make the doc-reference immediately clickable.

Comment 8

[Max Kanat-Alexander]

OK. I wouldn't object to having that in there, provided that it didn't look ugly.

We do have the current date of the last release already in there, also, on the
index page.

Comment 9

[Frédéric Buclin]

We removed all CVS markers in Bugzilla 3.4.6, so we won't bring them back.