(DON'T DELETE!!) ZSNES HTML Help Topic

The official forum for ZSNES documentation. Discuss future changes, mistakes, etc...
You can also join us on IRC at irc.freenode.net in #zsnes-docs.

Moderators: ZSNES Mods, ZSNES Doc Team

xamenus
Veteran
Posts: 907
Joined: Fri Jul 30, 2004 12:26 am

Post by xamenus »

Hmm, I can't seem to commit the CHM to CVS. Checking it out will get me a corrupted CHM. Anyone have any idea why?
Noxious Ninja
Dark Wind
Posts: 1271
Joined: Thu Jul 29, 2004 8:58 pm
Location: Texas
Contact:

Post by Noxious Ninja »

What CVS tool are you using?
[u][url=http://bash.org/?577451]#577451[/url][/u]
xamenus
Veteran
Posts: 907
Joined: Fri Jul 30, 2004 12:26 am

Post by xamenus »

A commandline CVSNT. It has had problems committing images as well.
Noxious Ninja
Dark Wind
Posts: 1271
Joined: Thu Jul 29, 2004 8:58 pm
Location: Texas
Contact:

Post by Noxious Ninja »

You need to get it to commit in binary mode. I'm not sure how to do that; TortoiseCVS, what I use, seems to do it automatically.
[u][url=http://bash.org/?577451]#577451[/url][/u]
xamenus
Veteran
Posts: 907
Joined: Fri Jul 30, 2004 12:26 am

Post by xamenus »

Noxious Ninja wrote:You need to get it to commit in binary mode. I'm not sure how to do that; TortoiseCVS, what I use, seems to do it automatically.
I'm not sure how to do that either, so do you think you could commit the CHM to the /chm folder in zsnes-docs-dev with TortoiseCVS? :) I'd appreciate if you'd commit the images as well into /unified/images (see Current to-do list thread). :) Thanks.
AspiringSquire
Born to Rule... Impatiently
Posts: 265
Joined: Wed Nov 17, 2004 8:21 pm
Location: Everywhere I want to be.
Contact:

Post by AspiringSquire »

Don't worry, IceFox. I just committed the CHM, and it works fine now. :)
You may need to delete your "chm" folder to get the new file working properly; that's what I had to do (after committing).
[url=http://board.zsnes.com/phpBB2/viewtopic.php?t=3298][color=brown]My [u]NES palette[/u][/color][/url] - better colors with any emulator.

"the more you know, and the more you can do... the more you are."
- [url=http://www.danielbohman.com][color=brown][u]daniel bohman[/u][/color][/url]
xamenus
Veteran
Posts: 907
Joined: Fri Jul 30, 2004 12:26 am

Post by xamenus »

AspiringSquire wrote:Don't worry, IceFox. I just committed the CHM, and it works fine now. :)
You may need to delete your "chm" folder to get the new file working properly; that's what I had to do (after committing).
Thanks, it works. :)

Are the images broken for you, too? Maybe you should re-commit those as well. :)
AspiringSquire
Born to Rule... Impatiently
Posts: 265
Joined: Wed Nov 17, 2004 8:21 pm
Location: Everywhere I want to be.
Contact:

Post by AspiringSquire »

IceFox wrote:Are the images broken for you, too? Maybe you should re-commit those as well. :)
Yes, they are. I can put up the images, too, but I think I may do some resizing/editing of the pics first, just so each have consistent height and width for the dimensions. ;)

BTW, I use TortoiseCVS. I tried the command-line program first but decided it wasn't worth the time (or frustration) it would take to learn how to use it. TortoiseCVS is incredibly easy to use; maybe you should try it. :)

http://tortoisecvs.sourceforge.net/
[url=http://board.zsnes.com/phpBB2/viewtopic.php?t=3298][color=brown]My [u]NES palette[/u][/color][/url] - better colors with any emulator.

"the more you know, and the more you can do... the more you are."
- [url=http://www.danielbohman.com][color=brown][u]daniel bohman[/u][/color][/url]
Nach
ZSNES Developer
ZSNES Developer
Posts: 3904
Joined: Tue Jul 27, 2004 10:54 pm
Location: Solar powered park bench
Contact:

Post by Nach »

I've tried using TortoiseCVS before, but could never get it to work. Not sure if the build I had was buggy or what.
May 9 2007 - NSRT 3.4, now with lots of hashing and even more accurate information! Go download it.
_____________
Insane Coding
xamenus
Veteran
Posts: 907
Joined: Fri Jul 30, 2004 12:26 am

Post by xamenus »

Nach wrote:I've tried using TortoiseCVS before, but could never get it to work. Not sure if the build I had was buggy or what.
I've tried it too, and also couldn't get it work. :/ My commandline version works for the .htm and .txt files at least, so I'll stick with it. :)
Nach
ZSNES Developer
ZSNES Developer
Posts: 3904
Joined: Tue Jul 27, 2004 10:54 pm
Location: Solar powered park bench
Contact:

Post by Nach »

I just checked out latest CVS for the CHM.

I'm not exactly impressed, and here's why:

Image

Anyone know what the problem is exactly?
May 9 2007 - NSRT 3.4, now with lots of hashing and even more accurate information! Go download it.
_____________
Insane Coding
Jipcy
Veteran
Posts: 768
Joined: Thu Feb 03, 2005 8:18 pm
Contact:

Post by Jipcy »

I think the new help file looks great, in both content and presentation.
[url=http://zsnes-docs.sf.net]Official ZSNES Docs[/url] | [url=http://zsnes-docs.sf.net/nsrt]NSRT Guide[/url] | [url=http://endoftransmission.net/phpBB3/viewtopic.php?t=394]Using a Wiimote w/ emulators[/url]
xamenus
Veteran
Posts: 907
Joined: Fri Jul 30, 2004 12:26 am

Post by xamenus »

Nach wrote:I just checked out latest CVS for the CHM.

I'm not exactly impressed, and here's why:

http://nsrt.edgeemu.com/images/zsnes/zchm.png

Anyone know what the problem is exactly?
For one thing, that's not the CHM in the latest CVS. The latest CHM has the "DOS Port Error Codes" section removed from both the Readme and the navigation.

Second, maybe it's an inconsistency with your Linux CHM viewer? It works just fine for me using the MS CHM viewer.
Nach
ZSNES Developer
ZSNES Developer
Posts: 3904
Joined: Tue Jul 27, 2004 10:54 pm
Location: Solar powered park bench
Contact:

Post by Nach »

IceFox wrote:For one thing, that's not the CHM in the latest CVS.
It was the latest in CVS when I posted that.

Same problem with the one added 10 hours ago.
IceFox wrote: The latest CHM has the "DOS Port Error Codes" section removed from both the Readme and the navigation.
Um...
Why?
IceFox wrote: Second, maybe it's an inconsistency with your Linux CHM viewer? It works just fine for me using the MS CHM viewer.
Worked with previous versions of the CHM.
All other CHMs I have work fine.

Revision 1.8 of the CHM in CVS is the last one that seems to work for me in xCHM.

What was changed then exactly?
May 9 2007 - NSRT 3.4, now with lots of hashing and even more accurate information! Go download it.
_____________
Insane Coding
Clements
Randomness
Posts: 1172
Joined: Wed Jul 28, 2004 4:01 pm
Location: UK
Contact:

Post by Clements »

Hmm, that looks pretty bad. Obviously Windows works perfectly otherwise I would have seen this issue and reported it straight away. There must have been a commit in the last 3 weeks since version 1.8 that broke everything.

What would be best is to create a series of compiles between v1.8 and v1.9 adding newer revisions as they come. As soon as the layout messes up or things disappear etc. there is the problem. I'm guessing style.css is causing it. From the screenshot I can't tell what is the problem. All the pages should be standards compliant now...
xamenus
Veteran
Posts: 907
Joined: Fri Jul 30, 2004 12:26 am

Post by xamenus »

Nach wrote:
IceFox wrote: The latest CHM has the "DOS Port Error Codes" section removed from both the Readme and the navigation.
Um...
Why?
Well, we decided to move that info to the FAQ. Seems more appropriate there IMO, since it's related to troubleshooting stuff.
Clements wrote:All the pages should be standards compliant now...
Actually, I probably broke something in the GUI page while creating a new section. :( That shouldn't affect the other pages though.
funkyass
"God"
Posts: 1128
Joined: Tue Jul 27, 2004 11:24 pm

Post by funkyass »

SF really needs to start offering Subversion repositories.
Nach
ZSNES Developer
ZSNES Developer
Posts: 3904
Joined: Tue Jul 27, 2004 10:54 pm
Location: Solar powered park bench
Contact:

Post by Nach »

funkyass wrote:SF really needs to start offering Subversion repositories.
Look on the status page to see how their conversion to Subversion is going.
Last I checked it said they were in the testing stage.
May 9 2007 - NSRT 3.4, now with lots of hashing and even more accurate information! Go download it.
_____________
Insane Coding
xamenus
Veteran
Posts: 907
Joined: Fri Jul 30, 2004 12:26 am

Post by xamenus »

Just a comment about the CHM:

Is the search feature particularly useful? I'm not so sure if the documentation is big enough to need it; we don't have several different topical sections in the documentation. :?

Removing the search feature would reduce the CHM filesize as well...
Nach
ZSNES Developer
ZSNES Developer
Posts: 3904
Joined: Tue Jul 27, 2004 10:54 pm
Location: Solar powered park bench
Contact:

Post by Nach »

I think search is extremely useful.

For example, opening the FAQ and just searching for joystick.
May 9 2007 - NSRT 3.4, now with lots of hashing and even more accurate information! Go download it.
_____________
Insane Coding
Clements
Randomness
Posts: 1172
Joined: Wed Jul 28, 2004 4:01 pm
Location: UK
Contact:

Post by Clements »

Even though we don't have that many pages, the search feature will highlight the key words in the text so it's easy to find stuff. I'm used to the find feature with FireFox so I thought this was the nearest thing.
Last edited by Clements on Fri Jun 17, 2005 3:51 am, edited 1 time in total.
AspiringSquire
Born to Rule... Impatiently
Posts: 265
Joined: Wed Nov 17, 2004 8:21 pm
Location: Everywhere I want to be.
Contact:

Post by AspiringSquire »

Clements wrote:Updated to 8/6/05 CVS (20:03 GMT+1), removed unnecessary FF images from source, smaller size
Clements, weren't you around when we discussed it and thought it better to include the images? Here is the conversation, summed up in a single post.
[url=http://board.zsnes.com/phpBB2/viewtopic.php?t=3298][color=brown]My [u]NES palette[/u][/color][/url] - better colors with any emulator.

"the more you know, and the more you can do... the more you are."
- [url=http://www.danielbohman.com][color=brown][u]daniel bohman[/u][/color][/url]
Clements
Randomness
Posts: 1172
Joined: Wed Jul 28, 2004 4:01 pm
Location: UK
Contact:

Post by Clements »

I hide the footer in the Help file anyway, and that was agreed long before since Firefox images in the Help file made no sense. Including them is pointless, only bloats the file size since they are impossible to view.

In the web-based HTML docs, leave them.
xamenus
Veteran
Posts: 907
Joined: Fri Jul 30, 2004 12:26 am

Post by xamenus »

Nach wrote:I think search is extremely useful.

For example, opening the FAQ and just searching for joystick.
By the way, Nach, does the CHM still display incorrectly in your CHM viewer?
Nach
ZSNES Developer
ZSNES Developer
Posts: 3904
Joined: Tue Jul 27, 2004 10:54 pm
Location: Solar powered park bench
Contact:

Post by Nach »

Yes, it is still messed up.
May 9 2007 - NSRT 3.4, now with lots of hashing and even more accurate information! Go download it.
_____________
Insane Coding
Post Reply