flat assembler
Message board for the users of flat assembler.
![]() Goto page 1, 2 Next |
Author |
|
JohnFound 17 Jan 2004, 22:29
Though, maybe .txt is better?
![]() We may convert it to any other format later. |
|||
![]() |
|
decard 22 Jan 2004, 17:24
OK I made some progress in the Guide - I wrote about whole Standard Macro Library. And I wrote about examples in \examples directory so it would be nice if you could put them there
![]() btw, I think that work package of Fresh should containg only necessary files (source+executable) - it would be smaller then ![]() outdated attachement removed - new version can be found below Last edited by decard on 27 Jan 2004, 20:37; edited 1 time in total |
|||
![]() |
|
JohnFound 22 Jan 2004, 18:43
Hi, Decard.
Very good work! ![]() Only one small addition: 4.4 - The "import" macro check whether the imported function is used and imports it only if it is used. So, the simplest way is to include coresponding include files from "%finc%/win32/apia/" directory in the import section and let FASM to determine what to import and what not. Actually it doesn't slow compilation more that 1..2 seconds even on slow computer. Fresh uses the same approach. Regards. |
|||
![]() |
|
decard 25 Jan 2004, 17:48
Hi John,
I found great tool that can be helper for writing the Fresh documentation - makedoc.exe utility from Allegro Library package. The idea is that you write your doc in special format. Actually you write in a normal way, you just have to add some symbols (like @heading to divide the doc into sections). Then makedoc will generate the documentation in the format of your choice - it can create plain text files, html, chm (it uses hhc.exe to compile it), rtf, and more ![]() ![]() I updated Fresh Guide, and attached it in both chm and txt formats. What do you think about the CHM version? I used allegro.css file from that library (its gift-ware ![]() regards outdated attachement removed - new version can be found below Last edited by decard on 27 Jan 2004, 20:38; edited 2 times in total |
|||
![]() |
|
Tomasz Grysztar 25 Jan 2004, 18:01
In the section about the "export" macro (4.5) you forgot that exported functions have to be sorted alphabetically, and therefore also your example is wrong. Also it's stated there that "It should be used in import section", while you mean the export section.
|
|||
![]() |
|
decard 25 Jan 2004, 18:17
Thanks, Privalov! I just updated the doc.
|
|||
![]() |
|
JohnFound 25 Jan 2004, 20:34
Hi Decard.
Really good work! I will include it in the Fresh package as soon as posible. CHM format is IMHO OK. I only have to read something about API to attach it to Fresh. BTW: What you think about including source text of the base examples in the CHM file. It will be good for user to have direct access to mentioned sources. Regards. |
|||
![]() |
|
decard 25 Jan 2004, 20:45
I wanted to do it myself. I looked at Html Help documentation, and its API seems t obe similar to WinHelp - you just have to call HtmlHelp function with CHM filename etc. The only problem is that HtmlHelp must be imported from hhctrl.ocx file, and I have no idea how to do it
![]() JohnFound wrote: BTW: What you think about including source text of the base examples in the CHM file. I was thinking about the same and I wanted to ask you about this ![]() regards |
|||
![]() |
|
Tomasz Grysztar 25 Jan 2004, 20:50
I have done it once for one of the early versions of FASMW, but I have removed it then, as I didn't like it. The idea is quite simple - you have to load hhctrl.ocx with LoadLibrary and get address of HtmlHelp function with GetProcAddress - but you have to set up at least 64K stack for your program to get it working at all.
|
|||
![]() |
|
JohnFound 25 Jan 2004, 20:54
OK, I leave it to you.
![]() ![]() Regards. |
|||
![]() |
|
decard 25 Jan 2004, 21:06
Quote: it seems to be normal DLL Well I already realized that but when I tried to link it statically my program didn't work. Now when I set the stack to 64k everything is OK. I just wonder why does it need so big stack ![]() |
|||
![]() |
|
JohnFound 25 Jan 2004, 21:07
Privalov wrote: The idea is quite simple - you have to load hhctrl.ocx with LoadLibrary... Well, I just make quick test and the importing via import section seems to work fine. (The OCX is loaded on start of Fresh) Do you think it is mandatory to load it via LoadLibrary? Regards. [EDIT] Well I write it too slow. ![]() |
|||
![]() |
|
Tomasz Grysztar 25 Jan 2004, 21:10
If you load it by import section, Fresh won't start on any Win32 system where hhctrl.ocx is not present (like Win95 with no HtmlHelp extension installed).
|
|||
![]() |
|
JohnFound 25 Jan 2004, 21:11
Hm, about the stack. It seems that HTML help uses a lot of OS resources, you know MS - every new version needs more resources.
![]() BTW: What you think about old fashioned HLP files? |
|||
![]() |
|
decard 25 Jan 2004, 22:17
CHM is better it is smaller (compression) and it is much easier to create (from HTML source). Some time ago I was trying to create a HLP and I found it very difficult. And now I have makedoc.exe that generates beautiful CHMs
![]() ![]() btw, there was already a discussinon about it and most remember? http://board.flatassembler.net/topic.php?t=780 ![]() |
|||
![]() |
|
JohnFound 25 Jan 2004, 22:26
Yea, I remember that discution. But I am still highly mixed-up and have no clear opinion.
![]() 1. HLP - Bad behaviour and features, but good API 2. CHM - Better behaviour and features but overbloated implementation. ![]() ![]() ![]() |
|||
![]() |
|
decard 25 Jan 2004, 22:38
I don't think that CHM is just a "MS invention" - now it is a standard, most new applications use it. Its API seems to be really simple too - we will just have to add some 'LoadLibrary' code in the initialization part. Also, even my slow machine works fine with CHM (even with bigger ones). And, as somebody mention in that topic, CHM seems to be more portable (it is supported in Linux) than HLP.
|
|||
![]() |
|
JohnFound 25 Jan 2004, 22:43
OK, Decard. Maybe you are right. At least when the one have no opinion ( I mean myself ) he have to listen the people that have.
![]() It's your part of Fresh, so make it and we will see what will happen. If I can help with something, just call me. BTW: Do you think that LoadLibrary is better than simple import in import section? Regards. |
|||
![]() |
|
decard 25 Jan 2004, 22:58
Yeah, because implementing it as LoadLibrary will be easy, and not having hhctrl.ocx can be a problem sometimes (maybe not too many people still use Win95, but I think that also Wine doesn't have this file as a standard
![]() |
|||
![]() |
|
Goto page 1, 2 Next < Last Thread | Next Thread > |
Forum Rules:
|
Copyright © 1999-2025, Tomasz Grysztar. Also on GitHub, YouTube.
Website powered by rwasa.