Mailman 3 March 1997 - Doc-SIG

[PYTHON DOC-SIG] Grabbing HTML version docs in one step
by tvalusek＠vs.inext.cz March 3, 1997

March 3, 1997

As for grabbing web sites, I think someone (Guido?) once posted a "robot" script. Could be an idea to check the locator: http://www.python.org/locator Cheers /F I looked there but I'm confused. Thanks for advice, anyway. Tom Valusek _______________ DOC-SIG - SIG for the Python Documentation Project send messages to: doc-sig(a)python.org administrivia to: doc-sig-request(a)python.org _______________

1 0

Re: [PYTHON DOC-SIG] Needed Python docs in RTF format
by Mark Hammond March 3, 1997

March 3, 1997

> Please help me get started with Python. Because of my weak eyes, I > have trouble reading PDF docs, and Winhelp files are hard to read > because some entries (especially contents entries with added text > are hard to acces using WinHelp95 Contents tab. I need to change > font size for best reading to ca. 14 pts. I am using Pythonwin with > Win95. Have you checked out all the Win95 options for this sort of thing? You may find you can adjust winhelp to a more suitable size. However, I admit to not knowing much about these options. I have the Python documents in RTF, but not a "general" RTF - only as the input for "WinHelp" which is not really setup for reading. What about grabbing the .HTML versions, and either configuring your browser of choice to use the big fonts? Thats the easiest I can come up with. Or else hack the postscript to create larger fonts, and then use some postscript viewer/printer. I know almost nothing about this route, but I imagine its not too difficult Mark. ---------------------------------------------------------------------- Mark Hammond - MHammond(a)skippinet.com.au Check out Python - _the_ language for the Web/CGI/Windows/MFC/Unix/etc <http://www.python.org> & <http://www.python.org/ftp/python/pythonwin> _______________ DOC-SIG - SIG for the Python Documentation Project send messages to: doc-sig(a)python.org administrivia to: doc-sig-request(a)python.org _______________

1 0

Re: [PYTHON DOC-SIG] New ni style example.
by Mark Hammond March 3, 1997

March 3, 1997

> I'd like to know where to find more specific information on the > proposals; are they public in any way? It sounds like a bad idea to I saw it in a 5 line PC Week (Aust) article, so it sisnt say much. It did say the MS' first proposal, and the modified ratified one, are not compatible, so Microsoft are holding off on a public beta until their tools support the raitified version. But it is very close. Their Web site may have info, but I have looked for it. > me, primarily because HTML just isn't strong enough for this kind of > thing. The HTML version should be generated from a more appropriate > format. I must admit to having the same thoughts, and MS pretty much _do_ have the technology to do this now! But then again, the only real problems I saw wrt moving from "winhelp" to "help" where these exact issues. It really isnt as if their existing toolset (ie, WinHelp) is anything that flash in itself. So while not a great step forward for them, it certainly wouldnt be backwards, and gives their marketting people something to play with (ie, they will tell you how they embrace Web standards by using HTML, but will surely neglect to mention that only their tools know about the format :-) Mark. ---------------------------------------------------------------------- Mark Hammond - MHammond(a)skippinet.com.au Check out Python - _the_ language for the Web/CGI/Windows/MFC/Unix/etc <http://www.python.org> & <http://www.python.org/ftp/python/pythonwin> _______________ DOC-SIG - SIG for the Python Documentation Project send messages to: doc-sig(a)python.org administrivia to: doc-sig-request(a)python.org _______________

1 0

Re: [PYTHON DOC-SIG] New ni style example.
by Mark Hammond March 1, 1997

March 1, 1997

> Ahh well... IMHO The indentation is far too wide.. Im glad we all agree here. In this particular case, one obvious problem is that _all_ objects are shown in the index. IMO, it would be vastly improved if only modules and sub-modules were included in the index. Unfortunately, the index generater has long ago lost what the original objects are - it only has the man-pages and filenames. This would be a reasonable change, to have the index generator work from the collectors too. And another Microsoft-centric rant, which I'd like to pass by you all. Microsoft is moving its entire help system to HTML!!! It is doing this in 2 ways: * By adding special keyword and indexing tags to the HTML standard, and submitting them for approval. Apparently, the relevant body modified it, renamed it, and ratified it. * By designing yet another something-or-other which allows many HTML files to be concatenated into some sort of container, including I think compression. They will then submit this to whoever does this stuff. The special tags for indexing and keywords are something I would find particularly useful - (even necessary) - the C based .HLP generator I have still produces far far superior documentation than HTMLgen - and largely for these reasons. Is anyone else interested in this? I definately wont find the time to look at this on my own, and Id really like to get gendoc where it makes really really good documentation - I fear my new optimism for all this stuff will wane... Mark. ---------------------------------------------------------------------- Mark Hammond - MHammond(a)skippinet.com.au Check out Python - _the_ language for the Web/CGI/Windows/MFC/Unix/etc <http://www.python.org> & <http://www.python.org/ftp/python/pythonwin> _______________ DOC-SIG - SIG for the Python Documentation Project send messages to: doc-sig(a)python.org administrivia to: doc-sig-request(a)python.org _______________

2 1

[PYTHON DOC-SIG] Needed Python docs in RTF format
by tvalusek＠vs.inext.cz March 1, 1997

March 1, 1997

Please help me get started with Python. Because of my weak eyes, I have trouble reading PDF docs, and Winhelp files are hard to read because some entries (especially contents entries with added text) are hard to acces using WinHelp95 Contents tab. I need to change font size for best reading to ca. 14 pts. I am using Pythonwin with Win95. Thank you. Tom Valusek _______________ DOC-SIG - SIG for the Python Documentation Project send messages to: doc-sig(a)python.org administrivia to: doc-sig-request(a)python.org _______________

1 0