Robert Premuz <rpremuz@srce.hr> said:
Robert> I've compared the two man pages and have concluded that they
Robert> differ in contents, and it seems the rman2html?scotty gave me
Robert> the latest version of the man page, while scotty.1 file in the
Robert> distribution is an older version of the man page.
Robert> It would be nice if the latest version of all the man pages
Robert> could always be found in the distribution too.
The distribution contains the man page that belongs to the
distribution while the Web server show the man page that belongs to
the scotty version installed on this machine. That's why they are a
bit different.
Robert> The manual says the following variables are set by scotty by
Robert> default:
This is due to the fact that the Web man page does not correspond to
you scotty version. I decided to use an array to store all scotty
related internal variables.
Robert> The scotty_mibs variable is also set but is not mentioned in
Robert> the man page at all.
I will add it to the man page.
Robert> The manual gives the following syntax for some of the mib commands:
[... text deleted ...]
Robert> Only the last one is the actual syntax, while in the preceding
Robert> mib commands, the -exact option should be placed just after
Robert> the mib key word, e.g. mib ?-exact? oid name.
Fixed in my sources now.
Robert> Also, I would recommend sticking to the style of the original
Robert> Tcl man pages in the syntax of the scotty commands. For
Robert> example, when describing optional parameters, it would be
Robert> better to use ?-exact? instead of [-exact] because of the
Robert> special meaning of characters [ and ] in Tcl.
What do others think about this?
Robert> So, it would be very nice if somebody put at least the latest
Robert> versions of all scotty/tkined man pages as *.1 ascii files on
Robert> a ftp archive (I'll convert them by rman at home). This would
Robert> make my life much easier. Any other suggestions?
I would recommend to use the scotty.1 man page found in the
distribution. The man page on the Web is not meant to be a reference
because it may be incompatible with the public available version.
Juergen