On Wed, Mar 12, 2003 at 12:17:00PM -0500, Jan Schaumann wrote:
> David Maxwell <david@netbsd.org> wrote:
> > 
> > Module Name:	htdocs
>  
> > Modified Files:
> > 	htdocs: index.html
> > 	htdocs/Changes: index.html index.list
> > 	htdocs/Security: advisory.html index.html patches-1.5.1.html
> > 	    patches-1.5.2.html patches-1.5.3.html patches-1.5.html
> > 	    patches-1.6.html
> > 
> > Log Message:
> > Publish NetBSD-SA2003-003.txt.asc Security Advisory
> 
> This commit put back very old events on the front page.  I guess you did
> not have up-to-date htdocs/gallery/events.*.
> 
> Furthermore, after adding news to Changes/index.list, it is necessary to
> regenerate the index pages for all translations.  This is easily done by
> 'make index' from the htdocs root.  See
> http://www.netbsd.org/developers/htdocs.html#adding-news-items for
> future reference. (I already put things back the way they should be.)

For people not working in htdocs regularly, I think it's unreasonable to
require a complete up to date htdocs checkout (or to know which parts
must be up to date). Particularly because of the size of the gallery, I
tend to avoid checking it out at all, or updating it.

At some point in time, I believe the instructions were "run make from
the Changes directory" -  and the output of that _appears_ convincing...

bester:0/home/david/bin/htdocs/Changes:5% make
perl ../list2html.pl -d index.list index.html
538 date entries (84 used).
cd ..; make index; cd Changes;
News for '.' ... done.
News for 'de' ... done.
News for 'es' ... done.
News for 'et' ... done.
News for 'fr' ... done.
News for 'ko' ... done.
News for 'lt' ... done.
News for 'nl' ... done.
News for 'pl' ... done.
News for 'pt' ... done.
News for 'ru' ... done.
News for 'se' ... done.
NEWS regen complete - time to 'make commit'

It looks like it stepped back up, and did a 'make index' in the root. It
didn't change any of the files in the language subdirs it mentions
though.

The problem with the documentation being in
htdocs.html#adding-news-items is knowing when to check it for changes.

Perhaps the top-level makefile could print a warning "NOTE: htdocs
update process last changed, Jan 1, 2003 - review
http://www.netbsd.org/developers/htdocs.html#adding-news-items for new
procedures"

-- 
David Maxwell, david@vex.net|david@maxwell.net -->
Any sufficiently advanced Common Sense will seem like magic... 
					      - me