Rui Paulo | 3 Mar 00:47 2006
Picon

Re: CVS commit: htdocs/de/Ports/xen

Roland Illig <rillig <at> netbsd.org> writes:

> Module Name:	htdocs
> Committed By:	rillig
> Date:		Thu Mar  2 22:48:21 UTC 2006
>
> Modified Files:
> 	htdocs/de/Ports/xen: howto.xml
>
> Log Message:
> Removed trailing white-space.

While I have no objections against the trailing white spaces under
<programlisting> and tags that matter, why do we need to remove
trainling white spaces from the other content?

--

-- 
  Rui Paulo			<rpaulo <at> {NetBSD{,-PT}.org,fnop.net}>

Jan Schaumann | 6 Mar 04:27 2006

proper DOCTYPE and validity

Hi,

Could somebody who knows more about this take a look at these two PRs?

admin/30763 - open critical high priority doc-bug
        www.netbsd.org/Misc/query-pr.html DOCTYPE does not match content
        http://www.NetBSD.org/cgi-bin/query-pr-single.pl?number=30763

misc/32221 - open critical medium priority sw-bug
        NetBSD's web documentation is not valid HTML
        http://www.NetBSD.org/cgi-bin/query-pr-single.pl?number=32221

It seems like the first one should be trivial to fix by simply providing
the proper DOCTYPE when generating the html files.  Alas, I do not know
what the right DOCTYPE is.

If we could then get the output from XML to be actually valid HTML, that
would be... well, I was going to say ``nice'', but actually it really
should be a basic requirement.

-Jan

--

-- 
My other computer also runs NetBSD!
			http://www.netbsd.org
Mike M. Volokhov | 6 Mar 17:03 2006
Picon

Re: proper DOCTYPE and validity

On Sun, 5 Mar 2006 22:27:50 -0500, Jan Schaumann wrote:

> Hi,
> 
> Could somebody who knows more about this take a look at these two PRs?
> 
> admin/30763 - open critical high priority doc-bug
>         www.netbsd.org/Misc/query-pr.html DOCTYPE does not match content
>         http://www.NetBSD.org/cgi-bin/query-pr-single.pl?number=30763
> 
> misc/32221 - open critical medium priority sw-bug
>         NetBSD's web documentation is not valid HTML
>         http://www.NetBSD.org/cgi-bin/query-pr-single.pl?number=32221
> 
> It seems like the first one should be trivial to fix by simply providing
> the proper DOCTYPE when generating the html files.  Alas, I do not know
> what the right DOCTYPE is.
> 
> If we could then get the output from XML to be actually valid HTML, that
> would be... well, I was going to say ``nice'', but actually it really
> should be a basic requirement.

If this is not so urgent, I'll assign both to me. If anyone have
something to do with them, please go ahead - I'd appreciate your help.

--
Mishka.

Brian Asemi | 10 Mar 03:44 2006
Picon

NetBSD Guide in Base System

This e-mail is continued from here:

http://www.netbsd.org/cgi-bin/query-pr-single.pl?number=33035

--- This is the full text of the e-mail I sent to gnats-bugs: ---

I would definitely like to see the entire NetBSD Guide in the base
system.  This would greatly benefit people without internet connections
or people who have no reason to install a web browser solely for the
purpose of accessing the Guide.  The Guide is a great piece of
documentation, IMHO, and making it more available by putting it in
/usr/share/doc in a readable format doesn't have any disadvantages that
I can see.

Making the docs that are already available in /usr/share/doc available
in formats that are readable at the command line without installing
additional software would be greatly helpful too.  Shipping docs with
the base system that are unreadable with the base system makes little
sense.  The only other solution to this that I see would be shipping a
text browser with the base system, but I doubt anyone wants to do that :P.

I'd like to hear some others opinions on this.

My two cents,
Brian

--- And this is Jeremy Reed's reply: ---

On Fri, 10 Mar 2006, Brian Asemi wrote:
 >  I'd like to hear some others opinions on this.
(Continue reading)

Pavel Cahyna | 10 Mar 10:20 2006
Picon

Re: NetBSD Guide in Base System

On Thu, Mar 09, 2006 at 09:44:13PM -0500, Brian Asemi wrote:
> This e-mail is continued from here:
> 
> http://www.netbsd.org/cgi-bin/query-pr-single.pl?number=33035
> 
> --- This is the full text of the e-mail I sent to gnats-bugs: ---
> 
> I would definitely like to see the entire NetBSD Guide in the base
> system.  This would greatly benefit people without internet connections
> or people who have no reason to install a web browser solely for the
> purpose of accessing the Guide.  The Guide is a great piece of
> documentation, IMHO, and making it more available by putting it in
> /usr/share/doc in a readable format doesn't have any disadvantages that
> I can see.

I think we should start with making available the shorter FAQs such as
http://www.netbsd.org/Documentation/misc/
or
http://www.netbsd.org/Documentation/network/

Those are quite short, have a high information content, and do not contain
graphics.

Pavel

Hubert Feyrer | 10 Mar 10:33 2006
Picon

Re: NetBSD Guide in Base System

On Thu, 9 Mar 2006, Brian Asemi wrote:
> I would definitely like to see the entire NetBSD Guide in the base
> system.

1) what formats do you have in mind, and how would you watch them (for
    non-text formats) with tools in the base system
2) the tools to process the XML files into whatnot are not in the base
    system, and I see no good reason to add a lot of big packages for a
    particular purpose to everyone's system. Those that want to do
    documentation work can install them seperately.

   - Hubert

Martin Husemann | 10 Mar 10:33 2006
Picon

Re: NetBSD Guide in Base System

Putting in the base system basically means: create a few more tar balls
(from htdocs/$LANG/Documentation) and allow sysinst to install it.
And branch htdocs, of course (not necessarily at the same time as src).

That part is easy. How much space will that cost on distribution media?

I don't like putting any browser in the base system though, most people will
install X and a graphical one anyway. Those who don't can use one from
pkgsrc.

Martin

Martin Husemann | 10 Mar 10:35 2006
Picon

Re: NetBSD Guide in Base System

On Fri, Mar 10, 2006 at 10:33:17AM +0100, Hubert Feyrer wrote:
> 1) what formats do you have in mind, and how would you watch them (for
>    non-text formats) with tools in the base system

If we'd go this route, I'd suggest: only the final html, and no tools
to view it (nor any xml tools).

Martin

Hubert Feyrer | 10 Mar 10:42 2006
Picon

Re: NetBSD Guide in Base System

On Fri, 10 Mar 2006, Martin Husemann wrote:
>> 1) what formats do you have in mind, and how would you watch them (for
>>    non-text formats) with tools in the base system
>
> If we'd go this route, I'd suggest: only the final html, and no tools
> to view it (nor any xml tools).

Do we have an HTML viewer in the base system?

On a related note, Charlie showed me "pkg_select" the other day, and I was 
very impressed. I think instead of frobbing around with more sets, the 
problem of installing packages in a convenient way from the base system 
should finally be attacked. Adding the NetBSD-Guide package can then be 
done just like adding firefox or links.

pkg_select can  be found in pkgsrc-wip.

  - Hubert

James Boothe | 10 Mar 13:56 2006

Re: NetBSD Guide in Base System

On Fri, Mar 10, 2006 at 10:35:41AM +0100, Martin Husemann wrote:
> On Fri, Mar 10, 2006 at 10:33:17AM +0100, Hubert Feyrer wrote:
> > 1) what formats do you have in mind, and how would you watch them (for
> >    non-text formats) with tools in the base system
> 
> If we'd go this route, I'd suggest: only the final html, and no tools
> to view it (nor any xml tools).
> 
> Martin

Now exactly what good would HTML docs be with nothing to view them?

--
James


Gmane