News:

MASM32 SDK Description, downloads and other helpful links
MASM32.com New Forum Link
masmforum WebSite

document reader

Started by Sevag.K, August 15, 2006, 05:21:08 AM

Previous topic - Next topic

Sevag.K

Here's a program I've been working on that could use bug testing if anyone is interested.

Works similar to Windows .hlp files, but without self-execution.  The document format is a simple text file formatted into sections.

One design issue I'm pondering.  At this time, bookmarks and notes are saved directly in the document file.
Pro:
-doesn't create extra files for each document to save notes/bookmarks

Cons:
-alters the original file, hidden bugs could spring to life and destroy the original.

I could use some input on this, should I keep it as is or have the program create a separate file/document.


v0.73
Notes/bookmarks are now saved in a separate file <document>.kinfo created in the same folder as the document.



[attachment deleted by admin]

PBrennick

I wil definitely be giving this one a try in my project!

Paul
The GeneSys Project is available from:
The Repository or My crappy website

Sevag.K

Thanks, let me know how it goes.  I think it's a great work that you are doing over there!

NPNW

sevag.K,

I would break it out into multiple documents or have a locking mechanism on the single file. You could append to the end and make the section written have all the parameters to make it modular. However if they are going to be adding sections anywhere in the document, then more overhead.

Basically your same argument, depends on how much functionality and usage you want out of the program.


Sevag.K

Currently, notes and bookmarks are appended to the end of the document.

I think separating them is the better option now that I think more about it.  With one file, you will lose any notes/bookmarks you have made if you ever get a new version of documents from the author.  If the files are separate, the notes/bookmarks will still work as long as the original sections haven't been altered.


Sevag.K

v0.73 updated in 1st post.
Now a new file is created for bookmarks/notes instead of modifying the original document.