Sorry your browser is not supported!

You are using an outdated browser that does not support modern web technologies, in order to use this site please update to a new browser.

Browsers supported include Chrome, FireFox, Safari, Opera, Internet Explorer 10+ or Microsoft Edge.

Geek Culture / Which format do you prefer?

Author
Message
Torrey
20
Years of Service
User Offline
Joined: 20th Aug 2004
Location: New Jersey
Posted: 8th Sep 2005 10:21
When it comes to reading documentation for an application you're using which do you prefer, HLP or CHM?

The best audio plugin for DarkBASIC Pro!
Plays Ogg Vorbis,MP3,FLAC,uncompressed WAV,AIFF,MOD,S3M,XM,and IT files.
John Y
Synergy Editor Developer
22
Years of Service
User Offline
Joined: 4th Sep 2002
Location: UK
Posted: 8th Sep 2005 10:36
I always make chm files as they seem pretty robust, as long as they are both supported on all windows natively then doesn't matter.

RegenProZ
19
Years of Service
User Offline
Joined: 20th Aug 2005
Location:
Posted: 8th Sep 2005 12:02
Both.

"Why do people depend on each other? In the end you're on your own." - Squall
Torrey
20
Years of Service
User Offline
Joined: 20th Aug 2004
Location: New Jersey
Posted: 9th Sep 2005 04:35
Thanks for the feedback. Lots of work on the horizon, not just the project you see in my sig, there's more to come.

The best audio plugin for DarkBASIC Pro!
Plays Ogg Vorbis,MP3,FLAC,uncompressed WAV,AIFF,MOD,S3M,XM,and IT files.
Raven
19
Years of Service
User Offline
Joined: 23rd Mar 2005
Location: Hertfordshire, England
Posted: 9th Sep 2005 05:25
Personally I prefer the new format Microsoft have used in Visual Studio 2005. It links directly with HTML Online so that you can always maintain up-to-date and consise help files, as well as altering the design and structure to fit the style of the help required.

It's also good cause they work perfectly in any web-browser making it multiplatform (if the need calls)

Microsoft have been shifting quite a bit of stuff to XML/HTML Hybrid. It definately makes it much easier and quicker to create such things. Only don't fall in the same pitfall as TheGameCreators and have the manual created by someone with no design sense.

Even if your manual has little information, provided it's easy to navigate and access the essencial stuff people are happy.

Louiz ofRohr
20
Years of Service
User Offline
Joined: 11th Nov 2004
Location:
Posted: 9th Sep 2005 06:24 Edited at: 9th Sep 2005 06:51
I think .swf is great (when it is used correctly)..

:edit:
oh! HLP or CHM? They are the same normal same for me..
I like HTML, too ^^ (I'm talking about HTML menu system,
like in DBP's help files).. I hate 700x700.000(scroll) HTML tutorials..
:edit:

The worst foe lies within the self..
Torrey
20
Years of Service
User Offline
Joined: 20th Aug 2004
Location: New Jersey
Posted: 9th Sep 2005 07:14
Quote: "Personally I prefer the new format Microsoft have used in Visual Studio 2005. It links directly with HTML Online so that you can always maintain up-to-date and consise help files, as well as altering the design and structure to fit the style of the help required.

It's also good cause they work perfectly in any web-browser making it multiplatform (if the need calls)

Microsoft have been shifting quite a bit of stuff to XML/HTML Hybrid. It definately makes it much easier and quicker to create such things. Only don't fall in the same pitfall as TheGameCreators and have the manual created by someone with no design sense.

Even if your manual has little information, provided it's easy to navigate and access the essencial stuff people are happy."


This is also included in the VS.Net 2003. I was using it yesterday to see how well it converts HLP format files. There are some really strange results on using its conversion features. To keep all the documentation online is a neat idea, but the problem is that you need a reference sometime and not have access to the internet.

Quote: "I think .swf is great (when it is used correctly)..

:edit:
oh! HLP or CHM? They are the same normal same for me..
I like HTML, too ^^ (I'm talking about HTML menu system,
like in DBP's help files).. I hate 700x700.000(scroll) HTML tutorials..
:edit:"


Flash help files! That'd be a load of extra work. CHM uses HTML files. Personally I like the feel of CHM over HLP, but use both regularly.

The best audio plugin for DarkBASIC Pro!
Plays Ogg Vorbis,MP3,FLAC,uncompressed WAV,AIFF,MOD,S3M,XM,and IT files.
enthusiast
20
Years of Service
User Offline
Joined: 8th Aug 2004
Location: ...
Posted: 9th Sep 2005 07:26
Ummm... not trying to sound stupid, but what is the difference between HLP and CHM?

System: AMD Athlon XP 2200+, nForce 2 ultra 400, 256 MB PC-2700 RAM, 40 GB 7200 Hard Drive, Geforce FX 5200 128 MB (64-bit), 56K modem
JoelJ
21
Years of Service
User Offline
Joined: 8th Sep 2003
Location: UTAH
Posted: 9th Sep 2005 07:57
Quote: "To keep all the documentation online is a neat idea, but the problem is that you need a reference sometime and not have access to the internet."

IF you have the REAL unpirated version of VS2003.net, it comes with THREE MSDN disks, when you install that, you have all the help files on your computer.


Eat some of dat cheese
Torrey
20
Years of Service
User Offline
Joined: 20th Aug 2004
Location: New Jersey
Posted: 9th Sep 2005 08:49
Quote: "Ummm... not trying to sound stupid, but what is the difference between HLP and CHM?"


HLP files are the old standard for help documentation. They use RTF files to compile out a help file.

CHM seems to be the newer format for help files these days. They use HTML files and other internet sources for the help documentation.

The best audio plugin for DarkBASIC Pro!
Plays Ogg Vorbis,MP3,FLAC,uncompressed WAV,AIFF,MOD,S3M,XM,and IT files.

Login to post a reply

Server time is: 2024-11-15 19:28:45
Your offset time is: 2024-11-15 19:28:45