Closed tbonfort closed 12 years ago
Author: woodbri@swoodbridge.com Date: 2004/02/19 - 19:29
One requirement to whatever you decide on is that the resulting documentation
output MUST fit and be printable on standard letter size or A4 paper.
The current documentation often does not print without chopping off the right
side of the page and everyone know that all the important stuff is crowded on
that side of the page and must be view in a browser by scrolling right/left
over the pages context.
Th only exception to this should be some (very few) pages that can not be
broken down into letter size pages using a different presentation of data and
those should probably be delivered as PDF documents so they can be easily
scaled to fit on a single printer page.
Author: sgillies@frii.com Date: 2004/02/19 - 19:45
Stephen,
Please, bug 576 concerns the _development_ documentation only.
Any concerns about the paper size (and I completely agree with
you on the A4) apply only to the issue of the MDP's user
documentation and should be reserved for a completely different
Bugzilla issue.
Author: dmorissette Date: 2004/02/24 - 19:14
Sean, I see that you have used the terminology mutable/immutable instead of
read-only/read-write in the current version of the docs at:
http://users.frii.com/sgillies/examples/mapscript.html.
I agree that we should stick to SWIG (or neutral) terminology as much as
possible, but in this case it seems to me that read-only/read-write or something
similar would be more intuitive for people not familiar with SWIG. I also find
that the spelling of mutable and immutable is so close that it's hard to
distinguish the two in a quick browse of the docs. Perhaps we could only mark
the immutable property and document the fact that properties are mutable unless
explicitly marked as immutable?
What do you think?
Author: sgillies@frii.com Date: 2004/02/24 - 19:42
Steve,
Good idea. All attributes are now read-write unless we explicitly
write 'immutable'.
Author: sgillies@frii.com Date: 2004/05/29 - 01:06
mapscript.txt is established, documentation of new methods is being
written. Closing this issue down.
Reporter: sgillies@frii.com Date: 2004/02/19 - 18:50