 |
|
|
|
|
|
| |
| |
|
|
|
|
| |
| |
|
|
On 08/30/2013 10:10 AM, Bald Eagle wrote:
>
>> yikes ... i don't think the syntax diagram could be /any/ clearer
>
> Well, that's the challenge with documenting anything or communicating via text.
> You'd be surprised by what can be misinterpreted or misunderstood.
>
> I myself am not always sure what makes something seem confusing at first, but
> then makes it 'click'.
>
> I think sometimes it might be easier on you to just write a large POV file with
> small illustrative examples of each directive, than to agonize over how best to
> describe their usage - especially considering the many languages POV users
> speak.
>
> A small example might be worth a page and a half of documentation.
>
>
>
>
holy mackerel you guys slay me!!!!
http://wiki.povray.org/content/Reference:Conditional_Directives#The_for_Directive
Post a reply to this message
|
|
| |
| |
|
|
|
|
| |
| |
|
|
Le 30/08/2013 16:55, James Holsenback nous fit lire :
>>
>>
>>
> holy mackerel you guys slay me!!!!
You can show them the text, you cannot force them to read it.
(I have the same issue at work with customers/coworkers and error
message: every details about how to solve the detected problem is in the
message ("set the damn environment variable FOO_BAR to the path of the
license file." (well, worded in marketing-speak, with PC everywhere),
yet they ask how to get past the complain. And it's the second line of
text, in red, in the opened console, and there is nothing after it....
Nah... "Yeah, it does not work, how do... "GRRRRR
James, You deserve a pat on the back.
Post a reply to this message
|
|
| |
| |
|
|
|
|
| |
| |
|
|
"Bald Eagle" <cre### [at] netscape net> wrote:
> > yikes ... i don't think the syntax diagram could be /any/ clearer
>
> Well, that's the challenge with documenting anything or communicating via text.
> You'd be surprised by what can be misinterpreted or misunderstood.
>
> I myself am not always sure what makes something seem confusing at first, but
> then makes it 'click'.
>
> I think sometimes it might be easier on you to just write a large POV file with
> small illustrative examples of each directive, than to agonize over how best to
> describe their usage - especially considering the many languages POV users
> speak.
>
> A small example might be worth a page and a half of documentation.
Yes, indeed, sometimes misunderstandings and misinterpretations between native
and nonnative speakers can yield a dispute here unwanted by both parts
completely. And there are other differences between the members of this still
wonderful community yielding different interpretations of - or different
feelings to - the same word. E.g. the word "death" will yield other emotions to
a former soldier, who risked his own life, than to a former male nurse, who had
to carry away the bodies of some hundred adolescents died from leukaemia.
May be Posfan12 has overlooked the explanation of the for-loop (which is
possible if he uses Windows 8, the POV help workes not really good with Windows
8) or he has not much experience with computer sciences. Imagine that you have
never learned about a for-loop so far. That is hard to imagine, but possible.
BTW: I don't think that anyone want's to slay you, James. What has a fish
(mackarel) to do with that?
Best regards,
Michael
Post a reply to this message
|
|
| |
| |
|
|
|
|
| |
| |
|
|
On 08/30/2013 12:05 PM, Le_Forgeron wrote:
> Le 30/08/2013 16:55, James Holsenback nous fit lire :
>>>
>>>
>>>
>> holy mackerel you guys slay me!!!!
>
> You can show them the text, you cannot force them to read it.
exactly ... reminds me of /another/ old saying, but I won't mention as
it will most likely be parsed incorrectly. btw: not implying you
>
> (I have the same issue at work with customers/coworkers and error
> message: every details about how to solve the detected problem is in the
> message ("set the damn environment variable FOO_BAR to the path of the
> license file." (well, worded in marketing-speak, with PC everywhere),
> yet they ask how to get past the complain. And it's the second line of
> text, in red, in the opened console, and there is nothing after it....
> Nah... "Yeah, it does not work, how do... "GRRRRR
>
>
> James, You deserve a pat on the back.
>
holy smokes ... thanks! lol ... not signaling the new pope
Post a reply to this message
|
|
| |
| |
|
|
|
|
| |
| |
|
|
On 30/08/2013 5:05 PM, Le_Forgeron wrote:
> James, You deserve a pat on the back.
I second that.
A difficult job well done without complaint.
Well not many. ;-)
--
Regards
Stephen
Post a reply to this message
|
|
| |
| |
|
|
|
|
| |
| |
|
|
On 30/08/2013 6:01 PM, MichaelJF wrote:
> BTW: I don't think that anyone want's to slay you, James. What has a fish
> (mackarel) to do with that?
Have you ever eaten mackerel that has gone off?
Seriously Michael, it is just a saying or the combination of two
sayings. And it means that Jim is showing his age. "Palm smack" may be
near the meaning.
The off line docs have problems but the online one is kept up to date by
Jim, very well.
You are right about the different needs of the user base. People like me
who cannot speak computer, need a primer in coding. Whilst to some, it
is just a reference doc. You can't really have them both with a mid
level user's needs, in the one document. I would say.
--
Regards
Stephen
Post a reply to this message
|
|
| |
| |
|
|
|
|
| |
| |
|
|
On 30-8-2013 18:05, Le_Forgeron wrote:
> James, You deserve a pat on the back.
>
And a medal :-)
Thomas
Post a reply to this message
|
|
| |
| |
|
|
|
|
| |
| |
|
|
James Holsenback <nom### [at] nonecom> wrote:
> On 08/29/2013 11:38 PM, posfan12 wrote:
> > Could someone please post an example of a #for loop? There is none in the docs.
> > (Which should be fixed, too.)
>
> yikes ... i don't think the syntax diagram could be /any/ clearer
> http://wiki.povray.org/content/Reference:Conditional_Directives#The_for_Directive
The docs weren't clear if one had to add #local or #declare before the
identifier, and I was confused regarding the End parameter - since most
programming languages use an inequality (as does POVray's #while statement).
Thanks for updating the wiki. One additional suggestion I'd make is to also
state what the example code is supposed to /produce/. I.e. a series of spheres
arranged evenly around a circle.
Mike
Post a reply to this message
|
|
| |
| |
|
|
|
|
| |
| |
|
|
On 08/31/2013 05:28 AM, posfan12 wrote:
> James Holsenback <nom### [at] nonecom> wrote:
>> On 08/29/2013 11:38 PM, posfan12 wrote:
>>> Could someone please post an example of a #for loop? There is none in the docs.
>>> (Which should be fixed, too.)
>>
>> yikes ... i don't think the syntax diagram could be /any/ clearer
>> http://wiki.povray.org/content/Reference:Conditional_Directives#The_for_Directive
>
> The docs weren't clear if one had to add #local or #declare before the
> identifier, and I was confused regarding the End parameter - since most
> programming languages use an inequality (as does POVray's #while statement).
>
> Thanks for updating the wiki. One additional suggestion I'd make is to also
> state what the example code is supposed to /produce/. I.e. a series of spheres
> arranged evenly around a circle.
ah ... well I'm going to decline to do that ... need to cut off changes
to docs because we're trying to do a release
Post a reply to this message
|
|
| |
| |
|
|
|
|
| |
| |
|
|
Stephen <mca### [at] aolcom> wrote:
> On 30/08/2013 6:01 PM, MichaelJF wrote:
> > BTW: I don't think that anyone want's to slay you, James. What has a fish
> > (mackarel) to do with that?
>
> Have you ever eaten mackerel that has gone off?
>
> Seriously Michael, it is just a saying or the combination of two
> sayings. And it means that Jim is showing his age. "Palm smack" may be
> near the meaning.
> The off line docs have problems but the online one is kept up to date by
> Jim, very well.
>
> You are right about the different needs of the user base. People like me
> who cannot speak computer, need a primer in coding. Whilst to some, it
> is just a reference doc. You can't really have them both with a mid
> level user's needs, in the one document. I would say.
>
> --
> Regards
> Stephen
I cannot remember to have ever eaten a mackerel at all. Clupea, atlantic cod,
plaice, eel, salmon and a very small part of a pike - the bigger part was
fetched from my plate by my late tomcat Arthur. I could not stop looking at him
feasting about it...
I guessed that Jim used "sayings" but expecially these are hard to translate. I
was happy to find a translation of his word "Yikes" at leo.org. Idioms or
sayings are not listed at Translation sites usually. leo becomes better and
better but not all can be found there.
And yes, I second that Jim does a wonderful job at the POV Wiki and earns a tap,
a medal and a hug for this,
Best regards,
Michael
Post a reply to this message
|
|
| |
| |
|
|
|
|
| |
