POV-Ray : Newsgroups : povray.unofficial.patches : format for documentation Server Time
2 Sep 2024 22:18:02 EDT (-0400)
  format for documentation (Message 16 to 25 of 55)  
<<< Previous 10 Messages Goto Latest 10 Messages Next 10 Messages >>>
From: Ken
Subject: Re: format for documentation
Date: 24 Jan 2000 08:28:54
Message: <388C52DB.B4EBC685@pacbell.net>
Axel Hecht wrote:

> What a Ken'ish reply that is.

And a good one it was. I'm glad someone keeps track of programming
links because I just don't have the time or experience to keep up
with them and evaluate their worth.

-- 
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: Axel Hecht
Subject: Re: format for documentation
Date: 24 Jan 2000 08:31:27
Message: <388C5431.7119E3B8@numerik.uni-kiel.de>
Well, yet another comment on formats, pdf uses the unisys patented
compression (like gif's), so having free tools that use the compression
features of pdf are probably illegal. And therefor dangerous.
Or you don't have compressions, that will result in file length equiv to
those of Postscript (without the messy bitmap files, ps sucks at those,
pdf supports jpg and png IIRC)

Axel


Post a reply to this message

From: Marc Schimmler
Subject: Re: format for documentation
Date: 24 Jan 2000 08:37:12
Message: <388C5587.745CBCE0@ica.uni-stuttgart.de>
Alan Kong wrote:
> 
>   I like .pdf for the official POV-Ray because it preserves example
> images, section numbers, and one can 'pagedown' through the document.
> Having one large document makes it easy to perform a search for
> keywords.

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.

Marc

-- 
Marc Schimmler


Post a reply to this message

From: Ron Parker
Subject: Re: format for documentation
Date: 24 Jan 2000 08:47:20
Message: <slrn88om01.v8.ron.parker@ron.gwmicro.com>
On Mon, 24 Jan 2000 14:25:43 +0100, Axel Hecht wrote:
>Ron Parker wrote:
>> 
>> On Sun, 23 Jan 2000 15:35:55 -0500, Nathan Kopp wrote:
>> >
>> >What would be the desired format for MegaPov documentation for Windows and
>> >Unix?
>> >Some other format that I could easily generate from a MS Word file using
>> >free tools.
>> 
>> DocBook!  DocBook!  (no free tools available yet, though, so you'll
>> have to write your own. :) )
>> 
>As I surf, jade is available on WIN32, so here your free tools
>go. (sgmltools is just a package with nice scripts to call jade).

Just to clarify: I meant that there aren't any free Word-based tools 
available yet.  That shouldn't be a hindrance, though, as you can 
write DocBook fairly easily in your favorite text editor.

-- 
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: Ken
Subject: Re: format for documentation
Date: 24 Jan 2000 08:54:20
Message: <388C58D1.DC907CB6@pacbell.net>
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.

-- 
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: 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

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

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