format PE console
entry start

include 'd:\programs\fasmw167\include\win32a.inc'     ; function macros
include 'fio.asm'                                        ; input / output

section '.data' data readable writeable

mess           db              "this is a test",13,10,0
num_show  db              "%d",13,10,0
out_filename  db              "out.txt",0
in_filename    db              "in.txt",0
testm           db              "test message",13,10,0
test_dbg    db              "test debug",13,10,0

; here I include the modules data
include              'module1.dat'
include              'module2.dat'


section '.bss' readable writeable

in_file   dd              ?
out_file   dd              ?


; here I include the modules bss
include                'module1.bss'
include              'module2.bss'


section '.code' code readable executable

start:


     ccall        in_init,in_filename              ; init input functions
        mov          [in_file],eax                    ; keep the context


    ccall        in_char,[in_file]
      ccall        dbg_print_num,eax                ; show what we got from the file
      ccall        in_char,[in_file]
      ccall        dbg_print_num,eax                ; show what we got from the file

  ccall        in_close,[in_file]


     cinvoke      ExitProcess,0                    ; exit and return zero

; here I include the modules assembly code
include               'module1.asm'
include              'module2.asm'


section '.idata' import data readable writable

  library kernel,'KERNEL32.DLL',msvcrt,'msvcrt.dll'

  import kernel,\
         ExitProcess,'ExitProcess'

  import msvcrt,\
       printf,'printf',\
        fprintf,'fprintf',\
      fopen,'fopen',\
  fclose,'fclose',\
        fgetc,'fgetc'

section '.reloc' fixups data readable discardable


    

I use fasm to compile directly into executable.
Can you recommend of a better way?

;FASMLIB
;Basic data definition macros

macro idata arg
{
  __IData equ __IData,   ;add one ',' to __IData, initial "__IData" before ','s will be used to call macro
  macro __IDataBlock     ;begin macro (or overload old one) which holds data inside "idata" block
  arg
}

macro udata arg
{
  __UData equ __UData,
  macro __UDataBlock
  arg
}

;include all "idata"-defined blocks
macro IncludeIData
{
  macro __IData dummy,[n]  ;create macro which will be invoked, [n] makes sure macro's forward will
  \{                       ;be preprocessed for each ',' added to __IData
    \forward
       align 4
       __IDataBlock        ;use the macro with data
       purge __IDataBlock  ;and remove it so previous macro becomes avilable
  \}
  match I, __IData \{ I \} ;and now unroll __IData macro (just "__IData" wouldn't do, replaced equate isn't
                           ;preprocessed anymore and so it wouldn't beheave as macro usage)
  purge __IData            ;__Idata macro is not needed anymore
}


;include all "udata"-defined blocks
macro IncludeUData         ;... same as IncludeIData but it is whole in virtual to count size and define labels
{                          ;and then required space is reserved
  macro __UData dummy,[n]
  \{
    \common
       \local ..begin, ..size
       ..begin = $
       virtual at $
    \forward
       align 4
       __UDataBlock
       purge __UDataBlock
    \common
       ..size = $ - ..begin
       end virtual
       rb ..size
   \}
  match U, __UData
  \{
    U
  \}
  purge __UData
}

;use both macros at least once
idata{}
udata{}    

If I do so , I my files won't be modular anymore.

include file1.inc
include file2.inc    

include inc.inc    

I'm trying to find a way to put stuff that have connection to each other together , in the same file , and not separate them.

I think i will take on my next "home" project a FASM DOC program that will generate some documentation out of code

Don't steal my idea

AsmDoc - HTML documentation generator

A Perl script which generates HTML documentation form the given source files, just like javadoc for Java: asmdoc.txt (2007-06-19).
The script is UTF-8 encoded and easy to translate into other languages. It generates valid HTML pages with no JavaScript, in any supported human language. Requires Perl 5.8 and a bunch of core modules. Run with no arguments to get help.