 |
 |
|
 |
|
 |
|  |
|  |
|
 |
From: Jaap Frank
Subject: Re: Proposal to expand the documentation about Arrays
Date: 20 Jan 2011 09:20:36
Message: <4d3844b4@news.povray.org>
|
|
 |
|  |
|  |
|
 |
>"Jim Holsenback" schreef in bericht news:4d383b61$1@news.povray.org...
>
>On 01/20/2011 09:23 AM, Jaap Frank wrote:
>> This piece of added text is a proposal to add to the documentation,
>> because this is possible with arrays.
>> The documentation gives no hint for this advanced use of arrays.
>> I know that very few users of POVRay are aware of it.
>> It can be added as point 3.2.1.8.3 Advanced use of Arrays.
>> Because English is not my native language it may be wise that someone
>> checks this text and then put it it in the documentation as proposal. I
>> don't know how to do that.
>
>At:
>http://wiki.povray.org/content/Documentation:Reference_Section_2.3#Declaring_Arrays
>
>the syntax diagram DOES mention the capability but there is little to no
>expansion on this concept. Is that what you're getting at? I'm not 1000%
>sure that the documentation is the correct place, but hey I might be
>persuaded to bow to the majority opinion ... maybe a KB "How To" article
>on the wiki might be a better choice
If you know it is possible to put arrays inside arrays, then you can read it
between the lines, but it's not explicitly mentioned.
Even clipka wasn't aware of it and was convinced that it was not possible,
see his reaction in this thread:
http://news.povray.org/povray.text.tutorials/thread/%3Cweb.4ab771232793170f772dd76f0%40news.povray.org%3E/
A link in the documentation to the wiki is naturally another possibility.
Post a reply to this message
|
 |
|  |
|  |
|
 |
From: Warp
Subject: Re: Proposal to expand the documentation about Arrays
Date: 20 Jan 2011 10:46:07
Message: <4d3858bf@news.povray.org>
|
|
 |
|  |
|  |
|
 |
In povray.general Jaap Frank <jjf### [at] casema nl> wrote:
> If you know it is possible to put arrays inside arrays, then you can read it
> between the lines, but it's not explicitly mentioned.
Since basically anything that can be #declared can also be put into an
array, it would be very strange if arrays made an odd exception to this
generic rule.
If it has to be specified explicitly, I don't think it deserves more
than a single sentence in the documentation (something along the lines
of "you can create a multidimensional array by making an array of arrays").
--
- Warp
Post a reply to this message
|
 |
|  |
|  |
|
 |
From: Jim Holsenback
Subject: Re: Proposal to expand the documentation about Arrays
Date: 20 Jan 2011 10:58:21
Message: <4d385b9d$1@news.povray.org>
|
|
 |
|  |
|  |
|
 |
On 01/20/2011 11:46 AM, Warp wrote:
> In povray.general Jaap Frank <jjf### [at] casema nl> wrote:
>> If you know it is possible to put arrays inside arrays, then you can read it
>> between the lines, but it's not explicitly mentioned.
>
> Since basically anything that can be #declared can also be put into an
> array, it would be very strange if arrays made an odd exception to this
> generic rule.
>
> If it has to be specified explicitly, I don't think it deserves more
> than a single sentence in the documentation (something along the lines
> of "you can create a multidimensional array by making an array of arrays").
>
agreed ... any expansion on the theme should come from the user
community (how to article)
Post a reply to this message
|
 |
|  |
|  |
|
 |
From: Jim Holsenback
Subject: Re: Proposal to expand the documentation about Arrays
Date: 20 Jan 2011 17:16:48
Message: <4d38b450$1@news.povray.org>
|
|
 |
|  |
|  |
|
 |
On 01/20/2011 11:46 AM, Warp wrote:
> If it has to be specified explicitly, I don't think it deserves more
> than a single sentence in the documentation (something along the lines
> of "you can create a multidimensional array by making an array of arrays").
>
it's been done ...
Post a reply to this message
|
 |
|  |
|  |
|
 |
From: Jaap Frank
Subject: Re: Proposal to expand the documentation about Arrays
Date: 21 Jan 2011 03:43:14
Message: <4d394722@news.povray.org>
|
|
 |
|  |
|  |
|
 |
>"Jim Holsenback" schreef in bericht news:4d38b450$1@news.povray.org...
>
>On 01/20/2011 11:46 AM, Warp wrote:
>> If it has to be specified explicitly, I don't think it deserves more
>> than a single sentence in the documentation (something along the lines
>> of "you can create a multidimensional array by making an array of
>> arrays").
>>
>
>it's been done ...
Can you change that in "you can create a multidimensional or
multivariable array by making an
array of arrays"
because the multi variable part is the interesting tric.
By the way, I've looked at the wiki, but you have to do that in html-style I
suppose and I'm not familiar with html or is there an easy way to do that.
Post a reply to this message
|
 |
|  |
|  |
|
 |
From: Jim Holsenback
Subject: Re: Proposal to expand the documentation about Arrays
Date: 21 Jan 2011 07:00:44
Message: <4d39756c$1@news.povray.org>
|
|
 |
|  |
|  |
|
 |
On 01/21/2011 04:43 AM, Jaap Frank wrote:
>> "Jim Holsenback" schreef in bericht news:4d38b450$1@news.povray.org...
>>
>> On 01/20/2011 11:46 AM, Warp wrote:
>>> If it has to be specified explicitly, I don't think it deserves more
>>> than a single sentence in the documentation (something along the lines
>>> of "you can create a multidimensional array by making an array of
>>> arrays").
>>>
>>
>> it's been done ...
>
> Can you change that in "you can create a multidimensional or
> multivariable array by making an
> array of arrays"
> because the multi variable part is the interesting tric.
maybe it's a language thing but i think were talking semantics here ...
i think multidimensional is the correct term
> By the way, I've looked at the wiki, but you have to do that in
> html-style I
> suppose and I'm not familiar with html or is there an easy way to do that.
for the documentation we mix wiki markup with html markup for
convenience, because eventually it ALL gets translated to html for the
distribution doc sets, however a how to article can be done all be done
in wiki markup it you wish. it's pretty easy once you get the hang of it
here the very basics:
http://wiki.povray.org/content/Help:Editing
and more details:
http://www.mediawiki.org/wiki/Help:Editing_pages
and of particular interest the Help:Formatting section
Post a reply to this message
|
 |
|  |
|  |
|
 |
From: clipka
Subject: Re: Proposal to expand the documentation about Arrays
Date: 22 Jan 2011 02:58:05
Message: <4d3a8e0d$1@news.povray.org>
|
|
 |
|  |
|  |
|
 |
Am 20.01.2011 15:20, schrieb Jaap Frank:
> If you know it is possible to put arrays inside arrays, then you can
> read it between the lines, but it's not explicitly mentioned.
> Even clipka wasn't aware of it and was convinced that it was not
> possible, see his reaction in this thread:
>
>
http://news.povray.org/povray.text.tutorials/thread/%3Cweb.4ab771232793170f772dd76f0%40news.povray.org%3E/
Heh, you're overestimating me :-)
Post a reply to this message
|
 |
|  |
|  |
|
 |
From: Jaap Frank
Subject: Re: Proposal to expand the documentation about Arrays
Date: 22 Jan 2011 09:24:56
Message: <4d3ae8b8$1@news.povray.org>
|
|
 |
|  |
|  |
|
 |
>"Jim Holsenback" schreef in bericht news:4d39756c$1@news.povray.org...
>
>...
>> Can you change that in "you can create a multidimensional or
>> multivariable array by making an
>> array of arrays"
>> because the multi variable part is the interesting tric.
>
>maybe it's a language thing but i think were talking semantics here ...
>i think multidimensional is the correct term
I don't disagree with multidimensional, but the manual states that once
an array is activated with a varaible type you only can use that type
further.
With arrays inside arrays you can build a multivariable array and that's the
point I would like to see in the manual. So mentioning BOTH can give a hint
in that directions.
>> By the way, I've looked at the wiki, but you have to do that in
>> html-style I
>> suppose and I'm not familiar with html or is there an easy way to do
>> that.
>
>for the documentation we mix wiki markup with html markup for
>convenience, because eventually it ALL gets translated to html for the
>distribution doc sets, however a how to article can be done all be done
>in wiki markup it you wish. it's pretty easy once you get the hang of it
>
>here the very basics:
>http://wiki.povray.org/content/Help:Editing
>
>and more details:
>http://www.mediawiki.org/wiki/Help:Editing_pages
>
>and of particular interest the Help:Formatting section
Thank you for this information. I will see if it's not too complicated.
Post a reply to this message
|
 |
|  |
|  |
|
 |
From: Jaap Frank
Subject: Re: Proposal to expand the documentation about Arrays
Date: 22 Jan 2011 09:33:45
Message: <4d3aeac9$1@news.povray.org>
|
|
 |
|  |
|  |
|
 |
>"clipka" schreef in bericht news:4d3a8e0d$1@news.povray.org...
>Am 20.01.2011 15:20, schrieb Jaap Frank:
>
>> If you know it is possible to put arrays inside arrays, then you can
>> read it between the lines, but it's not explicitly mentioned.
>> Even clipka wasn't aware of it and was convinced that it was not
>> possible, see his reaction in this thread:
>>
>>
http://news.povray.org/povray.text.tutorials/thread/%3Cweb.4ab771232793170f772dd76f0%40news.povray.org%3E/
>
>Heh, you're overestimating me :-)
Do I? ;-)
Post a reply to this message
|
 |
|  |
|  |
|
 |
From: clipka
Subject: Re: Proposal to expand the documentation about Arrays
Date: 23 Jan 2011 07:43:51
Message: <4d3c2287$1@news.povray.org>
|
|
 |
|  |
|  |
|
 |
Am 22.01.2011 15:24, schrieb Jaap Frank:
> I don't disagree with multidimensional, but the manual states that once
> an array is activated with a varaible type you only can use that type
> further.
> With arrays inside arrays you can build a multivariable array and that's
> the
> point I would like to see in the manual. So mentioning BOTH can give a hint
> in that directions.
Personally, I'd be reluctant to "sell" this in the official docs as a
solution for multi-variable arrays, as it would prompt people to
complain that this is a quite unwieldy solution - and rightly so: It's
not a solution at all; it was never /designed/ to fulfil this role, it's
just a kludge that happens to work.
For the docs, I'd suggest to just mention that arrays with different
element types can still live well alongside each other in an array of
arrays.
Post a reply to this message
|
 |
|  |
|  |
|
 |
|
 |
|  |