Qbasicnews.com

Qbasic "like" compilers/interpreters => FB Documentation => Topic started by: Skyler on June 09, 2006, 05:04:59 PM



Title: Downloadable documentation?
Post by: Skyler on June 09, 2006, 05:04:59 PM
Is there a downloadable help-file style documentation for FB? That's the main reason I haven't switched to FB yet, because I don't have a handy reference file.


Title: Downloadable documentation?
Post by: TheAdventMaster on June 09, 2006, 05:08:41 PM
http://www.freebasic.net/forum/viewtopic.php?t=4491


Title: Downloadable documentation?
Post by: Zack on June 09, 2006, 05:16:42 PM
I think the latest version of FBIde has a feature which allows you to press F1 over any keyword and it will display the corrosponding help section.


Title: Re: Downloadable documentation?
Post by: Moneo on June 09, 2006, 09:14:30 PM
Quote from: "Skyler"
Is there a downloadable help-file style documentation for FB? That's the main reason I haven't switched to FB yet, because I don't have a handy reference file.


I feel the same way, I want a complete manual that I can download, print, and browse at my leasure. I don't think there is such a manual, just help text scattered about, readme type files, tutorials, examples, etc. Granted, such a manual would undergo revisions. I too hesitate on jumping in to FB mainly for this reason.

*****


Title: Re: Downloadable documentation?
Post by: TheAdventMaster on June 09, 2006, 09:39:40 PM
Quote from: "Moneo"
Granted, such a manual would undergo revisions. I too hesitate on jumping in to FB mainly for this reason.
So the link I posted meant nothing? ;_;


Title: Re: Downloadable documentation?
Post by: Moneo on June 09, 2006, 11:16:09 PM
Quote from: "TheAdventMaster"
Quote from: "Moneo"
Granted, such a manual would undergo revisions. I too hesitate on jumping in to FB mainly for this reason.
So the link I posted meant nothing? ;_;

I went to that link, and it took me to a forum on FB documentation. Not exactly downloadable documentation, you must agree.
*****


Title: Re: Downloadable documentation?
Post by: TheAdventMaster on June 10, 2006, 02:43:52 AM
Quote from: "Moneo"
Quote
So the link I posted meant nothing? ;_;
I went to that link, and it took me to a forum on FB documentation. Not exactly downloadable documentation, you must agree.*****
I took *me* to the thread in which there's a link to downloadable documentation of FreeBASIC. . .


Title: Downloadable documentation?
Post by: Dr_Davenstein on June 10, 2006, 03:07:05 AM
Moneo, there is a downloadable doc now. I can't remember who to give the credit to, so I guess I just wont. :lol:

I put a copy here (http://fileanchor.com/32243-d), in case you have problems with sf.net or something. ;)


Title: Downloadable documentation?
Post by: Moneo on June 10, 2006, 07:18:49 PM
Thanks, Dr_D.


Title: Downloadable documentation?
Post by: Dr_Davenstein on June 10, 2006, 07:33:48 PM
No problem. I wouldn't bother to print it yet though. As you said earlier, the manual would require unknown revisions, since the compiler is still evolving. It is frustrating sometimes, but we're in on the ground floor, sending input to the engineers, ya know? We could never do that if Microsoft was developing it.    :king:  

And that reminds me...
Has anyone else heard the rumor that Microsoft will be shipping a new version of QB with Vista?


Title: Downloadable documentation?
Post by: Moneo on June 11, 2006, 12:03:49 AM
Quote from: "Dr_Davenstein"
No problem. I wouldn't bother to print it yet though. As you said earlier, the manual would require unknown revisions, since the compiler is still evolving. It is frustrating sometimes, but we're in on the ground floor, sending input to the engineers, ya know? We could never do that if Microsoft was developing it.    :king:  

And that reminds me...
Has anyone else heard the rumor that Microsoft will be shipping a new version of QB with Vista?

Regarding printing it now, maybe I'll just print in light pencil, he,he.

I haven't heard about any QB in Vista. But, you can be sure that if they did something like that, it would be incompatible with our beloved QB, and would subsequently put the final nail into the coffin of our QB. Freebasic and all the other "new" Basics, would also follow closely behind. You can't compete with a potential audience of millions of Microsoft Windows users adopting this new QB.


Title: Downloadable documentation?
Post by: Antoni Gual on June 11, 2006, 02:00:39 AM
It seems QBasic1.1 works more or less in Vista, provided you don't do graphics
http://www.network54.com/Forum/13959/message/1149642194/QBasic+and+windows+Vista
Vista has a ntvdm more restricted than XP's.


Title: Downloadable documentation?
Post by: coderJeff on June 19, 2006, 11:48:01 PM
Hi all.

Missed it by a few days: (Jun 11)

(Unofficial) FreeBasic Manual Download Page

http://frontpage.execulink.com/coder/freebasic/docs.asp

I plan to update the download every few weeks.

I wrote a program in freebasic to download pages from the freebasic wiki and convert to html/chm.  I am currently working on a text version of the manual for DOS.


Title: Downloadable documentation?
Post by: relsoft on June 20, 2006, 12:11:32 PM
Nice site @coderjeff.  Downloading the CHM format. :*)


Title: Downloadable documentation?
Post by: coderJeff on July 14, 2006, 09:30:51 PM
(http://www.execulink.com/~coder/fb/docs/fbhelp-testing.png)

... something for the hardcore dos freaks. :P

fbhelp.exe (dos) and fbhelpw.exe (windows) console help viewer for FreeBASIC manual.

Still lots to do, but I would like to get feedback on how it runs under dos/windows and any feature requests.

Source under a GNU compatible license will eventually be available.  Binaries only for this testing release.

Download available from my (Unoffiicial) FreeBASIC Manual page:
http://frontpage.execulink.com/coder/freebasic/docs.asp

Important keys: F1=DocToc, F2=readme, CTRL+X = Exit.

Thanks!

EDIT: Oops.  I first built the download with an older snapshot of the wiki.  For more recent wiki.  Please DL again, sorry.


Title: Downloadable documentation?
Post by: Anonymous on July 15, 2006, 02:56:11 PM
Whoa dude, now THIS is awesome!

I won't ever use it probably but still... Awesome XD


edit: i see you want feedback/testing. so i guess i WILL use it then ;]

edi2: 2 things i noticed so far (testing the DOS version under win ME)

1) at the bottom, there are some "·", I assume that is supposed to be replaced with some other symbol... but i dont know what. maybe "|" ?


2) When holding the mouse button and "scrolling" i.e. like if you were selecting a large group of text and moving off screen the thing scrolls WAY too fast; you'll instantly go from bottom to top if dragging up, and vice versa if going down ;]

edit3: clicking a link in the FAQ, makes the cursor jump to the title line but.. its on the BOTTOM of the screen... should be on the top, I think

edit4: i clicked on the "find more informatino on reading get/put buffers "HERE" thing, and there was no way back... x.x and then after screwing around in that window for a while dragging up and down quickly i caused a crash... =P



i like the look tho, very soft on the eyes, like qb's.

Really good idea...


Title: Downloadable documentation?
Post by: coderJeff on July 15, 2006, 03:41:11 PM
The "·" is from a user putting html directly in the wiki topic:  which works fine if the output format is html (chm), but not so good otherwise.  I'll either have to parse html codes, or remove them from the wiki.  grr.

heh, lightning-speed-scroll is not exactly useful: I can add a scroll delay and a side scroll bar.

I'll note the point about the anchors.

Edit: I tried really hard to pretend to be frustrated and scroll randomly, but, I couldn't produce the crash.

ESC or BACKSPACE, will return to a previous topic, and F1 goes to the start page.

Thanks for trying it out!


Title: Downloadable documentation?
Post by: Anonymous on July 15, 2006, 05:53:33 PM
anytime.

post a version compiled with -g and i can attempt to reproduce the crash within gdb, if you'd like.


Title: Downloadable documentation?
Post by: DrV on July 15, 2006, 11:40:55 PM
Looks really nice. :D

The Windows version on Windows XP (and probably any OS with a scrollable console - Windows 2000, etc.) has a slight problem - it apparently thinks the screen is as tall as the total scrollable buffer, not just the visible screen, so the bottom of the screen is way down at 300 lines.  I assume this is because WIDTH returns the size of that scrollable region, which I remember being discussed a while ago - I'll see if I can dig that up; the current behavior seems somewhat useless.  To avoid this, you could set the console size manually with WIDTH, but that seems non-optimal.  Also, the scroll wheel doesn't work in full screen, but I think that is a known/possibly unsolvable problem.  (The scroll wheel input should also work on "real" DOS with a CuteMouse 2.0+ mouse driver - I'll have to test this sometime. :) )


Title: Downloadable documentation?
Post by: tbbw on July 16, 2006, 05:42:52 AM
Quote from: "coderJeff"
... something for the hardcore dos freaks. :P

fbhelp.exe (dos) and fbhelpw.exe (windows) console help viewer for FreeBASIC manual.

Still lots to do, but I would like to get feedback on how it runs under dos/windows and any feature requests.

Source under a GNU compatible license will eventually be available.  Binaries only for this testing release.

Download available from my (Unoffiicial) FreeBASIC Manual page:
http://frontpage.execulink.com/coder/freebasic/docs.asp

Important keys: F1=DocToc, F2=readme, CTRL+X = Exit.

Thanks!

EDIT: Oops.  I first built the download with an older snapshot of the wiki.  For more recent wiki.  Please DL again, sorry.


hahahahaha now that has a nice qb feal to the manual :D


Title: Downloadable documentation?
Post by: rdc on July 16, 2006, 09:23:47 AM
Quote from: "DrV"
The Windows version on Windows XP (and probably any OS with a scrollable console - Windows 2000, etc.) has a slight problem - it apparently thinks the screen is as tall as the total scrollable buffer, not just the visible screen, so the bottom of the screen is way down at 300 lines.


Yeah, this is a problem with the NT based consoles since the default buffers are 300. What I did was right click the title bar, select Properties from the menu and the Layout tab. You can change the default settings there. I changed it to 80 by 40. You also need to uncheck the Quick Edit checkboxes under the Options tab so the mouse will work. Since you can save the settings for future sessions, you only have to do this once.

One suggestion for the windows version: Putting a little Close button up in the top right corner--Turbo Vision style--would be nice. Good  job on this.


Title: Downloadable documentation?
Post by: coderJeff on July 16, 2006, 09:31:54 AM
@tbbw,  thanks.

@Drv,  The dos version behaves correctly in a scrollable window.  The windows version does not.  It should probably work the same as the dos version.  (i.e. like running qb or edit in a window).  Currently the word wrap is fixed at 76 columns, which is done by the help file generator.  (not the viewer)

I don't think I have ever changed the screen buffersize from 80x25 until just now.  I always used mode con lines=50.  I also see that the windows version does not work at all with a screenbuffer wider than 80 columns.  I'm bypassing some of the fb run-time stuff.  Maybe I shouldn't do that, or try to remember why I did that, and possibly report bugs on the fbrt.

You'll still need the "fbhelp.dat" file from the exe download for this to work.

EDIT: Old source link deleted.

Quote from: "rdc"
One suggestion for the windows version: Putting a little Close button up in the top right corner--Turbo Vision style--would be nice. Good job on this.


Good idea and easy to do.  Thanks

EDIT: To follow this topic see here: http://www.freebasic.net/forum/viewtopic.php?t=5002

Thanks