headers
Klaus Heinz | 9 Jun 2006 01:35
Picon

How to include src/doc/ROADMAP in our web pages

Hi

attached is a patch for creating htdocs/Goals/roadmap.html.

In order for this to work, you need to have a directory tree with
sources for NetBSD-current on your machine (only for the single file
src/doc/ROADMAP :-/) and set CURRENTSRCDIR.htdocs to this directory
in your /etc/mk.conf.
I did not use NETBSDSRCDIR (from bsd.own.mk) because this may not be
a src tree for -current. On my machine it contains netbsd-3.

Since src/doc/ROADMAP will remain a simple text file, I chose <screen>
to include it verbatim in roadmap.xml because it represents this fact
better than <literallayout>, IMO.

The patch must be applied in /usr/htdocs/Goals/.

Opinions, suggestions?

ciao
     Klaus
Attachment (diff): text/x-diff, 1987 bytes
Permalink | Reply | 11 comments |
headers
Rui Paulo | 10 Jun 2006 01:24

Re: How to include src/doc/ROADMAP in our web pages

At Fri, 9 Jun 2006 01:35:21 +0200,
Klaus Heinz wrote:
> 
> Hi
> 
> attached is a patch for creating htdocs/Goals/roadmap.html.
> 
> In order for this to work, you need to have a directory tree with
> sources for NetBSD-current on your machine (only for the single file
> src/doc/ROADMAP :-/) and set CURRENTSRCDIR.htdocs to this directory
> in your /etc/mk.conf.
> I did not use NETBSDSRCDIR (from bsd.own.mk) because this may not be
> a src tree for -current. On my machine it contains netbsd-3.
> 
> Since src/doc/ROADMAP will remain a simple text file, I chose <screen>
> to include it verbatim in roadmap.xml because it represents this fact
> better than <literallayout>, IMO.

I agree with you.

> The patch must be applied in /usr/htdocs/Goals/.
> 
> Opinions, suggestions?

What about using NETBSDSRCDIR or BSDSRCDIR instead of CURRENTSRCDIR.htdocs ?
The rest looks pretty reasonable.
Permalink | Reply | 10 comments |
headers
Klaus Heinz | 10 Jun 2006 15:02
Picon

Re: How to include src/doc/ROADMAP in our web pages

Rui Paulo wrote:

> What about using NETBSDSRCDIR or BSDSRCDIR instead of CURRENTSRCDIR.htdocs ?
> The rest looks pretty reasonable.

I already described my reason for that:

> > I did not use NETBSDSRCDIR (from bsd.own.mk) because this may not be
> > a src tree for -current. On my machine it contains netbsd-3.

ciao
     Klaus
Permalink | Reply | 9 comments |
headers
Rui Paulo | 10 Jun 2006 16:09

Re: How to include src/doc/ROADMAP in our web pages

At Sat, 10 Jun 2006 15:02:48 +0200,
Klaus Heinz wrote:
> 
> Rui Paulo wrote:
> 
> > What about using NETBSDSRCDIR or BSDSRCDIR instead of CURRENTSRCDIR.htdocs ?
> > The rest looks pretty reasonable.
> 
> I already described my reason for that:
> 
> > > I did not use NETBSDSRCDIR (from bsd.own.mk) because this may not be
> > > a src tree for -current. On my machine it contains netbsd-3.

Sorry, my mistake.
I don't have objections on this, please go ahead if no one objects.
Permalink | Reply | 1 comment |
headers
Rui Paulo | 10 Jun 2006 16:12

Re: How to include src/doc/ROADMAP in our web pages

At Sat, 10 Jun 2006 15:09:44 +0100,
Rui Paulo wrote:
> 
> At Sat, 10 Jun 2006 15:02:48 +0200,
> Klaus Heinz wrote:
> > 
> > Rui Paulo wrote:
> > 
> > > What about using NETBSDSRCDIR or BSDSRCDIR instead of CURRENTSRCDIR.htdocs ?
> > > The rest looks pretty reasonable.
> > 
> > I already described my reason for that:
> > 
> > > > I did not use NETBSDSRCDIR (from bsd.own.mk) because this may not be
> > > > a src tree for -current. On my machine it contains netbsd-3.
> 
> Sorry, my mistake.
> I don't have objections on this, please go ahead if no one objects.

Actually, what about:

<![ %sgml.includes; [
    <screen><inlinemediaobject><imageobject><imagedata
            fileref="ROADMAP"
            format="linespecific"></imagedata></imageobject></inlinemediaobject>
    </screen>
]]>
<![ %xml.includes; [
    <screen><xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
        href="ROADMAP" parse="text" /></screen>
(Continue reading)

Permalink | Reply | 0 comments |
headers
Martin Husemann | 11 Jun 2006 00:12
Picon

Re: How to include src/doc/ROADMAP in our web pages

On Sat, Jun 10, 2006 at 03:02:48PM +0200, Klaus Heinz wrote:
> > > I did not use NETBSDSRCDIR (from bsd.own.mk) because this may not be
> > > a src tree for -current. On my machine it contains netbsd-3.

How about defaulting your new variable to NETBSDSRCDIR though?

(I think the right way would be to "cvs co" the roadmap file in a temporary
directory, but that would probably cause too much other complications)

Martin
Permalink | Reply | 6 comments |
headers
Klaus Heinz | 11 Jun 2006 19:01
Picon

Re: How to include src/doc/ROADMAP in our web pages

Martin Husemann wrote:

> How about defaulting your new variable to NETBSDSRCDIR though?
> 
> (I think the right way would be to "cvs co" the roadmap file in a temporary
> directory, but that would probably cause too much other complications)

I thought about this as well, but since roadmap.html is _always_ built
this would need a net connection (for "cvs co") only for building htdocs.

This whole concept of using a file in different CVS tree from where it
lives opens a can of worms :-/. If I update htdocs I do not necessarily
update current-src. I cannot use make's ability to track outdated files
because CVS does not preserve timestamps. NETBSDSRCDIR does not
necessarily point at current sources.

I actually think it would be better to duplicate the file ROADMAP in
htdocs. If changes really happen rarely this should be feasible, we
could even provide a make-target for this and put a short note at the
top of the file.

ciao
     Klaus
Permalink | Reply | 5 comments |
headers
Rui Paulo | 11 Jun 2006 23:26

Re: How to include src/doc/ROADMAP in our web pages

At Sun, 11 Jun 2006 19:01:00 +0200,
Klaus Heinz wrote:
> I actually think it would be better to duplicate the file ROADMAP in
> htdocs. If changes really happen rarely this should be feasible, we
> could even provide a make-target for this and put a short note at the
> top of the file.

Yes, this makes sense. Can you raise the question at board <at>  or core <at> ,
please ?

Thanks.
Permalink | Reply | 2 comments |
headers
Martin Husemann | 11 Jun 2006 23:45
Picon

Re: How to include src/doc/ROADMAP in our web pages

On Sun, Jun 11, 2006 at 10:26:25PM +0100, Rui Paulo wrote:
> Yes, this makes sense. Can you raise the question at board <at>  or core <at> ,
> please ?

I'm not sure I have seen all the early stages of this, but IIRC the idea
to only have one copy of the file came from www <at>  (in reply to board <at>  asking
to include the file in the web page somehow).

Martin
Permalink | Reply | 1 comment |
headers
Mike M. Volokhov | 20 Jun 2006 17:01
Picon

Re: How to include src/doc/ROADMAP in our web pages

Martin Husemann <martin <at> duskware.de> wrote:
> On Sun, Jun 11, 2006 at 10:26:25PM +0100, Rui Paulo wrote:
> > Yes, this makes sense. Can you raise the question at board <at>  or core <at> ,
> > please ?
> 
> I'm not sure I have seen all the early stages of this, but IIRC the idea
> to only have one copy of the file came from www <at>  (in reply to board <at>  asking
> to include the file in the web page somehow).

And I (can't speak for the rest of www) still believe that it is possible.
Excuse me for the herecy, but I really see no troubles with ROADMAP
in XML format. All that we need is a three forms of data representation:o

	1. paragraphs (para)
	2. headers (section, title)
	3. lists (itemizedlist, orderedlist, listitem)

Ah, I forget to mention some stuff like <email> and <ulink>. Just
take a look to the following example:

	<listitem>
	  <para>Review TCP/IP developments</para>
	  <itemizedlist>
	    <listitem>
	      <para>Fix NewReno</para>
	      <para>Responsible: mycroft</para> <para>ETA: (3.0)</para>
	    </listitem><listitem>
	      <para>Add SACK support to the kernel.</para>
	      <para>Responsible: kurahone</para> <para>ETA: (3.0)</para>
	    </listitem><listitem>
(Continue reading)

Permalink | Reply | 0 comments |

Gmane