POV-Ray : Newsgroups : povray.documentation.inbuilt : how are dist. doc mistakes handled? Server Time
28 Mar 2024 09:22:31 EDT (-0400)
  how are dist. doc mistakes handled? (Message 1 to 9 of 9)  
From: omniverse
Subject: how are dist. doc mistakes handled?
Date: 30 Sep 2016 00:20:01
Message: <web.57ede719b90612ffb1933f770@news.povray.org>
Was curious about the "template" subfolders, files I have from Win64 3.7.1
alpha, since I found one error in a 'txt' which is displayed when clicking on
the corresponding HTML image link via _index.htm:

 // ----------------- HF_Sphere macro
#declare Fn_1 =
 function(x, y, z)
  {1-(-f_snoise3d(x*7,y*7,z*7)*0.5 }

a final  ) missing before }

Didn't know if these things were being reported here at p.d.i. and somehow fixed
by someone for later distributions or what, but had me wondering if the program
download was ever being updated without a change of version or revision while
such things got changed.
Assuming there are people or a person actively correcting the distribution
files.

Or would this only matter for the next major update?

Unfortunately I have nothing else to report... or fortunate as you might see
it... only this very minor mistake. Thought I would try to be diligent when
looking through those SDL txt files, albeit a tiny bit at a time, and tell of
anything else amiss I might find.

Just thinking I might be too late, not knowing fixes have been done before I get
to them.

Thanks to anyone with the answer!


Post a reply to this message

From: William F Pokorny
Subject: Re: how are dist. doc mistakes handled?
Date: 30 Sep 2016 09:36:45
Message: <57ee6a6d$1@news.povray.org>
On 09/30/2016 12:16 AM, omniverse wrote:
> Was curious about the "template" subfolders, files I have from Win64 3.7.1
> alpha, since I found one error in a 'txt' which is displayed when clicking on
> the corresponding HTML image link via _index.htm:
>
>  // ----------------- HF_Sphere macro
> #declare Fn_1 =
>  function(x, y, z)
>   {1-(-f_snoise3d(x*7,y*7,z*7)*0.5 }
>
> a final  ) missing before }
>
> Didn't know if these things were being reported here at p.d.i. and somehow fixed
> by someone for later distributions or what, but had me wondering if the program
> download was ever being updated without a change of version or revision while
> such things got changed.
> Assuming there are people or a person actively correcting the distribution
> files.
>
> Or would this only matter for the next major update?
>
> Unfortunately I have nothing else to report... or fortunate as you might see
> it... only this very minor mistake. Thought I would try to be diligent when
> looking through those SDL txt files, albeit a tiny bit at a time, and tell of
> anything else amiss I might find.
>
> Just thinking I might be too late, not knowing fixes have been done before I get
> to them.
>
> Thanks to anyone with the answer!
>
>

I don't myself use the windows interface templates, but I suppose here 
or povray.bugreports OK groups to report an issue with a template file.

Something this small might get rolled into other updates by the 
developers on their seeing it. In any case, I've put in a github pull 
req #101 against the master branch, adding the closing paren. That req 
will be addressed or closed as already done by the developers at some 
later time.

As to when a fix gets out so to speak, it generally depends on when and 
how the developers adopt it - and perhaps how the user installs any new 
version with the fix. I don't though know how these windows template 
files are used / integrated into the windows version on POV-Ray.

Bill P.


Post a reply to this message

From: omniverse
Subject: Re: how are dist. doc mistakes handled?
Date: 30 Sep 2016 11:15:01
Message: <web.57ee80633486308eb1933f770@news.povray.org>
William F Pokorny <ano### [at] anonymousorg> wrote:
> On 09/30/2016 12:16 AM, omniverse wrote:
> > Was curious about the "template" subfolders, files I have from Win64 3.7.1
> > alpha, since I found one error in a 'txt' which is displayed when clicking on
> > the corresponding HTML image link via _index.htm:
--->8 --- 8<---
> >
> > Just thinking I might be too late, not knowing fixes have been done before I get
> > to them.
> >
>
> I don't myself use the windows interface templates, but I suppose here
> or povray.bugreports OK groups to report an issue with a template file.
>
> Something this small might get rolled into other updates by the
> developers on their seeing it. In any case, I've put in a github pull
> req #101 against the master branch, adding the closing paren. That req
> will be addressed or closed as already done by the developers at some
> later time.
>
> As to when a fix gets out so to speak, it generally depends on when and
> how the developers adopt it - and perhaps how the user installs any new
> version with the fix. I don't though know how these windows template
> files are used / integrated into the windows version on POV-Ray.
>
> Bill P.

Okay, thanks Bill!

I just realized the Help menu has bug reports showing info in the help file. So
trying the "bug tracker" link there it failed to get to the web page at

http://bugs.povray.org/setup/upgrade.php

Needless to say, I seldom ever see that toolbar menu as I always go to the help
directly or online.

And now noticed the Show Tip there doesn't do anything either, as well as the
same found in Options menu, Other Settings.
Again, I probably haven't looked for those help tips for years!

Happy to say I haven't come across any other SDL errors in those templates yet,
other than typo/misspelling. To me operable SDL important, spelling not as much.

I was thinking more about that HF_sphere macro.
It's text file doesn't have #include "shapes.inc" like another macro does,
meaning there isn't a consistency to how those template txt files are done.
Probably been that way since day 1.  :)
If a Windows POV-Ray (new?) user didn't know that include file is needed to run
the macro they must search for a reason why it doesn't do so alone.

I didn't have any luck finding a direct way to open a web browser to show those
template pages from the program itself, thought I might have overlooked it. Sure
seems like it needs one if there isn't yet.
Did see the Tools menu, 'Browse sample scenes folder' to get there that way.
Just needed to go into templates subfolder from there and locate the _index.htm
file to open that getting the web browser going for it.

Bob


Post a reply to this message

From: William F Pokorny
Subject: Re: how are dist. doc mistakes handled?
Date: 1 Oct 2016 06:25:07
Message: <57ef8f03$1@news.povray.org>
On 09/30/2016 11:10 AM, omniverse wrote:
>
> Okay, thanks Bill!
>
> I just realized the Help menu has bug reports showing info in the help file. So
> trying the "bug tracker" link there it failed to get to the web page at
>
> http://bugs.povray.org/setup/upgrade.php
>

This site has been down for a while. It's been replaced with the github 
issues tracker. I'll see if I can find and update the link in the 
distribution. (Aside: I have on my might-try-list moving some of the old 
open flyspray bugs over to github issues. Suppose this would have to be 
done from a web snap shot of the site if it cannot be brought back up)

> Needless to say, I seldom ever see that toolbar menu as I always go to the help
> directly or online.
>
> And now noticed the Show Tip there doesn't do anything either, as well as the
> same found in Options menu, Other Settings.
> Again, I probably haven't looked for those help tips for years!
>
> Happy to say I haven't come across any other SDL errors in those templates yet,
> other than typo/misspelling. To me operable SDL important, spelling not as much.
>
> I was thinking more about that HF_sphere macro.
> It's text file doesn't have #include "shapes.inc" like another macro does,
> meaning there isn't a consistency to how those template txt files are done.
> Probably been that way since day 1.  :)
> If a Windows POV-Ray (new?) user didn't know that include file is needed to run
> the macro they must search for a reason why it doesn't do so alone.

Ah yes! This is what Sven ran into a year or more ago. I didn't realize 
it while adding that paren... I'll put adding that include to all the HF 
templates on my todo list to update via another pull request. Thanks for 
the reminder!

>
> I didn't have any luck finding a direct way to open a web browser to show those
> template pages from the program itself, thought I might have overlooked it. Sure
> seems like it needs one if there isn't yet.
> Did see the Tools menu, 'Browse sample scenes folder' to get there that way.
> Just needed to go into templates subfolder from there and locate the _index.htm
> file to open that getting the web browser going for it.
>
> Bob
>
>
>

Where I can see a way to safely & quickly make windows related updates 
as a linux user I'll give it a go. I don't run windows POV-Ray, so some 
of what you wrote about the menus is lost on me.

Bill P.


Post a reply to this message

From: Jim Holsenback
Subject: Re: how are dist. doc mistakes handled?
Date: 1 Oct 2016 06:52:25
Message: <57ef9569$1@news.povray.org>
On 10/1/2016 6:25 AM, William F Pokorny wrote:
> This site has been down for a while. It's been replaced with the github
> issues tracker. I'll see if I can find and update the link in the
> distribution.

if yer talkin bout link(s) in docs ... know exactly where but just 
haven't gotten round2it


Post a reply to this message

From: Jim Holsenback
Subject: Re: how are dist. doc mistakes handled?
Date: 1 Oct 2016 07:33:43
Message: <57ef9f17@news.povray.org>
On 10/1/2016 6:52 AM, Jim Holsenback wrote:
> if yer talkin bout link(s) in docs ... know exactly where but just
> haven't gotten round2it

before i forget /again/ changed in four places: 
http://wiki.povray.org/content?title=Special:RecentChanges&hidebots=0


Post a reply to this message

From: William F Pokorny
Subject: Re: how are dist. doc mistakes handled?
Date: 1 Oct 2016 10:16:52
Message: <57efc554$1@news.povray.org>
On 10/01/2016 07:33 AM, Jim Holsenback wrote:
> On 10/1/2016 6:52 AM, Jim Holsenback wrote:
>> if yer talkin bout link(s) in docs ... know exactly where but just
>> haven't gotten round2it
>
> before i forget /again/ changed in four places:
> http://wiki.povray.org/content?title=Special:RecentChanges&hidebots=0
>
Thanks Jim.

I found a couple of references to the old flyspray bug site in the unix 
subdirectory and I have created a pull request to change them to the 
github issues URL.

I found a couple other references to the old site at:

./doc/html/t2_5.html
./doc/html/u1_7.html

but I do not know how the html files in the doc directory are 
generated/maintained - so I made no attempt to update these.

Aside: I also generated a pull req to update the HF_* macro templates to 
all have a shapes.inc include.

Bill P.


Post a reply to this message

From: Jim Holsenback
Subject: Re: how are dist. doc mistakes handled?
Date: 2 Oct 2016 06:54:46
Message: <57f0e776$1@news.povray.org>
On 10/1/2016 10:16 AM, William F Pokorny wrote:
> I found a couple other references to the old site at:
>
> ./doc/html/t2_5.html

found twice and corrected here: 
http://wiki.povray.org/content/Documentation:Tutorial_Section_5#Appendices

> ./doc/html/u1_7.html

deleted the obsolete reference here: 
http://wiki.povray.org/content/Documentation:Unix_Section_7#Known_Bugs

> but I do not know how the html files in the doc directory are
> generated/maintained - so I made no attempt to update these.

when i run wikidocgen and post results


Post a reply to this message

From: William F Pokorny
Subject: Re: how are dist. doc mistakes handled?
Date: 2 Oct 2016 10:47:31
Message: <57f11e03$1@news.povray.org>
On 10/02/2016 06:54 AM, Jim Holsenback wrote:
> On 10/1/2016 10:16 AM, William F Pokorny wrote:
>> I found a couple other references to the old site at:
>>
>> ./doc/html/t2_5.html
>
> found twice and corrected here:
> http://wiki.povray.org/content/Documentation:Tutorial_Section_5#Appendices
>
>> ./doc/html/u1_7.html
>
> deleted the obsolete reference here:
> http://wiki.povray.org/content/Documentation:Unix_Section_7#Known_Bugs
>
>> but I do not know how the html files in the doc directory are
>> generated/maintained - so I made no attempt to update these.
>
> when i run wikidocgen and post results
>
Thanks for updates & info on how those html files are created.


Post a reply to this message

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