POV-Ray : Newsgroups : povray.unofficial.patches : format for documentation Server Time
2 Sep 2024 18:17:33 EDT (-0400)
  format for documentation (Message 21 to 30 of 55)  
<<< Previous 10 Messages Goto Latest 10 Messages Next 10 Messages >>>
From: Ron Parker
Subject: Re: format for documentation
Date: 24 Jan 2000 09:04:56
Message: <slrn88on11.v8.ron.parker@ron.gwmicro.com>
On Mon, 24 Jan 2000 05:51:13 -0800, Ken wrote:
>
>
>Marc Schimmler wrote:
>
>> A few months ago I would have disagreed but now I can only support .pdf.
>> It's quite useful as an online doc. I like the official one very much
>> now.
>
>I don't mind .pdf all that much but the only free tool that I know of
>to read them (Adobe Acrobat) really sucks big time in my opinion.

GhostScript can read PDF as well, but I think it's even harder to use, 
UI-wise.

-- 
These are my opinions.  I do NOT speak for the POV-Team.
The superpatch: http://www2.fwi.com/~parkerr/superpatch/
My other stuff: http://www2.fwi.com/~parkerr/traces.html


Post a reply to this message

From: TonyB
Subject: Re: format for documentation
Date: 24 Jan 2000 09:18:11
Message: <388c5f23@news.povray.org>
>Just to comment on that, layers aren't supported by many browsers, e.g.
>mozilla does not support this netscape HTML-enhancement.


Oh, I know that... I was just being selfish. <g>


Post a reply to this message

From: Y Tanabe
Subject: Re: format for documentation
Date: 24 Jan 2000 09:23:13
Message: <388C6041.FDCFF0CF@kh.rim.or.jp>
Dear  Mr.Nathan Kopp

I am a Japanese,and Official manual is very difficult to uderstand for me.
So in my case,
I take out mainly Syntax from manual and put them into header of source file.

And I check Token.c,Parser.c etc. files,
and I add comments(Of cource Japanese) each function,pattern and so on.
Now I make all images of all functions,pattern and so on,
then I can not make pattern of  "facets" inside pigments,
so I check source and add only use inside  "normal" message like this.

I hope plain text is better.
I attach half way of my manual of functions.
Of cource I put this in source file.

Y.Tanabe
Kobe,Japan


Nathan Kopp wrote:

> What would be the desired format for MegaPov documentation for Windows and
> Unix?
>
> Available formats to choose from:
>
> WordPerfect
> MS Word 97
> MS Word (simple, read by WordPad)
> PostScript
> PDF (only if I can generate it with free tools)
> HTML (export from MS Word)
> Some other format that I could easily generate from a MS Word file using
> free tools.
>
> (Sorry, but I don't have any tools to generate HLP files for Windows.)
>
> -Nathan


Post a reply to this message


Attachments:
Download 'manual.doc.txt' (18 KB)

From: Nathan Kopp
Subject: Re: format for documentation
Date: 24 Jan 2000 09:31:50
Message: <388c6256@news.povray.org>
Nathan Kopp <Nat### [at] Koppcom> wrote ...
>
> What would be the desired format for MegaPov documentation for Windows and
> Unix?
>

I guess I worded that poorly.  I was hoping for answers like:
  "I use unix, and I'd like _____."
or
  "I use Windows, and I'd like ______."

For example, the Windows people might like HLP (if I can figure out how to
use it) or Wordpad, but the unix people might prefer HTML or PS.

Of course, I'll have to figure out some good primary format that both myself
and the Smellenbergh brothers can work on and then export/import to the
other formats.

-Nathan


Post a reply to this message

From: Ken
Subject: Re: format for documentation
Date: 24 Jan 2000 09:33:48
Message: <388C6211.49A89FE4@pacbell.net>
"I use Windows, and I'd like HLP."

-- 
Ken Tyler -  1300+ Povray, Graphics, 3D Rendering, and Raytracing Links:
http://home.pacbell.net/tylereng/index.html http://www.povray.org/links/


Post a reply to this message

From: Nathan Kopp
Subject: Re: format for documentation
Date: 24 Jan 2000 09:34:02
Message: <388c62da@news.povray.org>
Glen Berry <7no### [at] ezwvcom> wrote...
> I think it might also be nice to allow end-user modification of the
> help file.  If the help file is in a modular HTML format, it would be
> possible for the end-user to add some new pages, correct a typo on an
> existing page, or make whatever personal notes they wanted. It would
> become more of a personalized "workbook" in a sense. I can't do these
> things to a PDF, PostScript, or Windows Help document.

The problem with multiple files is that they are more difficult to maintain
and distribute than a single file that contains the entire document.

> As for Windows users of MegaPov, it might be nice to simply launch a
> Windows Help file, but I can easily live without this if it will be
> too much work to create.

Like I said, if I can get free tools to export from a word processor to HLP,
I'll give it a try.  I'll try that tool that Tony recommended.

-Nathan


Post a reply to this message

From: Ron Parker
Subject: Re: format for documentation
Date: 24 Jan 2000 10:10:44
Message: <slrn88oqsc.v8.ron.parker@ron.gwmicro.com>
On Mon, 24 Jan 2000 06:30:41 -0800, Ken wrote:
>  "I use Windows, and I'd like HLP."

I use Windows and Unix, and I'd like DocBook because you can easily transform
it into PDF, HTML, RTF, TeX, and lots of other formats.

-- 
These are my opinions.  I do NOT speak for the POV-Team.
The superpatch: http://www2.fwi.com/~parkerr/superpatch/
My other stuff: http://www2.fwi.com/~parkerr/traces.html


Post a reply to this message

From: Jim Kress
Subject: Re: format for documentation
Date: 24 Jan 2000 12:42:40
Message: <388c8f10@news.povray.org>
I use Windows and I prefer HTML.

Jim

--

Nathan Kopp <Nat### [at] Koppcom> wrote in message
news:388b6675@news.povray.org...
>
> What would be the desired format for MegaPov documentation for Windows and
> Unix?
>
> Available formats to choose from:
>
> WordPerfect
> MS Word 97
> MS Word (simple, read by WordPad)
> PostScript
> PDF (only if I can generate it with free tools)
> HTML (export from MS Word)
> Some other format that I could easily generate from a MS Word file using
> free tools.
>
> (Sorry, but I don't have any tools to generate HLP files for Windows.)
>
> -Nathan
>
>


Post a reply to this message

From: TonyB
Subject: Re: format for documentation
Date: 24 Jan 2000 13:15:40
Message: <388c96cc@news.povray.org>
>I am a Japanese,and Official manual is very difficult to uderstand for me.
>So in my case,
>I take out mainly Syntax from manual and put them into header of source
file.
>
>And I check Token.c,Parser.c etc. files,
>and I add comments(Of cource Japanese) each function,pattern and so on.
>Now I make all images of all functions,pattern and so on,
>then I can not make pattern of  "facets" inside pigments,
>so I check source and add only use inside  "normal" message like this.
>
>I hope plain text is better.
>I attach half way of my manual of functions.
>Of cource I put this in source file.


:O   Bakemono!


Post a reply to this message

From: Bob Hughes
Subject: Re: format for documentation
Date: 24 Jan 2000 14:12:50
Message: <388ca432@news.povray.org>
Win. HTML.
Couldn't some sort of generic html be made as a single page (file)?

Bob


Post a reply to this message

<<< Previous 10 Messages Goto Latest 10 Messages Next 10 Messages >>>

Copyright 2003-2023 Persistence of Vision Raytracer Pty. Ltd.