1. Manual: some routines shown as constants?
- Posted by Dan M. Jul 13, 2008
- 695 views
Is this intentional??
Section 4.9.1, from ...6 to ...12, are routines, not constants.
And 4.21.1, Constants under Sequence Manipulation, not needed?
4.22 (Sets) doesn't have a "Page Contents" category listing like other items, though I very much like the "extra"(?) notes explaining the category itself. In fact, I'd like to see more such explanations.
4.25.1 (Constants under Stack) also not needed?
4.31.1 (Constants under Unit Testing Framework) also not needed? And this section is one that really could use some explanation, as I don't think what it's all about is described anywhere else?? (That is, tell what is unit testing??)
Any update on whether you can add short descriptions to the various routines listings under various "Page Contents" category listings?
And on maybe removing the outline style numbering from the listing of routines on "Page Contents" (not from the actual main manual/outline, so reference can be made numerically)? This would be both so the routine names stand out, and for more room for possible short descriptions.
Dan
2. Re: Manual: some routines shown as constants?
- Posted by CChris Jul 13, 2008
- 698 views
Is this intentional??
Section 4.9.1, from ...6 to ...12, are routines, not constants.
And 4.21.1, Constants under Sequence Manipulation, not needed?
4.22 (Sets) doesn't have a "Page Contents" category listing like other items, though I very much like the "extra"(?) notes explaining the category itself. In fact, I'd like to see more such explanations.
4.25.1 (Constants under Stack) also not needed?
4.31.1 (Constants under Unit Testing Framework) also not needed? And this section is one that really could use some explanation, as I don't think what it's all about is described anywhere else?? (That is, tell what is unit testing??)
Any update on whether you can add short descriptions to the various routines listings under various "Page Contents" category listings?
And on maybe removing the outline style numbering from the listing of routines on "Page Contents" (not from the actual main manual/outline, so reference can be made numerically)? This would be both so the routine names stand out, and for more room for possible short descriptions.
Dan
Most of the files you quote are under conversion to the new format. I'm working on sets.e right now. Hopefully everything is converted by next saturday. 4.22 and before could be ready tonight, tomorrow at worst.
Just wondered what happened to lib_sets.htx, but I'm rebuilding the contents from my master file from ESL anyway.
CChris
3. Re: Manual: some routines shown as constants?
- Posted by Dan M. Jul 13, 2008
- 679 views
Is this intentional??
Section 4.9.1, from ...6 to ...12, are routines, not constants.
And 4.21.1, Constants under Sequence Manipulation, not needed?
4.22 (Sets) doesn't have a "Page Contents" category listing like other items, though I very much like the "extra"(?) notes explaining the category itself. In fact, I'd like to see more such explanations.
4.25.1 (Constants under Stack) also not needed?
4.31.1 (Constants under Unit Testing Framework) also not needed? And this section is one that really could use some explanation, as I don't think what it's all about is described anywhere else?? (That is, tell what is unit testing??)
Any update on whether you can add short descriptions to the various routines listings under various "Page Contents" category listings?
And on maybe removing the outline style numbering from the listing of routines on "Page Contents" (not from the actual main manual/outline, so reference can be made numerically)? This would be both so the routine names stand out, and for more room for possible short descriptions.
Dan
Most of the files you quote are under conversion to the new format. I'm working on sets.e right now. Hopefully everything is converted by next saturday. 4.22 and before could be ready tonight, tomorrow at worst.
Just wondered what happened to lib_sets.htx, but I'm rebuilding the contents from my master file from ESL anyway.
CChris
Ok, just happened to notice them, didn't know you were already working on them
Dan
4. Re: Manual: some routines shown as constants?
- Posted by Jeremy Cowgar Jul 13, 2008
- 684 views
Ok, just happened to notice them, didn't know you were already working on them
Dan, this is good stuff. Although we are working on docs, I am sure there are very many errors that we do not know about. Please keep the error reports coming as you find them. If we know about them already, that's fine. If we do not, that's great!
Jeremy
5. Re: Manual: some routines shown as constants?
- Posted by Dan M. Jul 13, 2008
- 663 views
Ok, just happened to notice them, didn't know you were already working on them
Dan, this is good stuff. Although we are working on docs, I am sure there are very many errors that we do not know about. Please keep the error reports coming as you find them. If we know about them already, that's fine. If we do not, that's great!
Jeremy
Ok, good, was afraid I might have been just being a pest!
Dan