Re: Technics to improve (?) the sources readability.

Thanks for all the answers.

----- Original Message -----
From: "Bob Nash" <BNash_at_smud.org>
..
> The purpose of the code as I read it is to postpone the execution of a word
> to later in the source code to make the definition more readable.

Another goal is to isolate a phrase in a sequence of words.
..
> I hope the above is not misunderstood: I realize that the comments may not
> directly apply to the effort to improve readability and documentation.

I think now its better to improve the text formating and/or
to factor.

----- Original Message -----
From: "Gene LeFave" <gene_at_tekdata.com>

> ...In your example I might want to change it to something like:
>
> VARIABLE MH
> : PROJECTION MH @ FCV_SET_PROJECTION 0 MSG>VIEW DROP ;
> : CUBE MH @ FCV_ADD_OBJECT CreateCube MSG>VIEW DROP ;
> : RENDER MH @ FCV_SET_RENDER_MODE 2 MSG>VIEW DROP ;
> : VIEW_KEY MH @ FCV_VIEW_KEY 0 MSG>VIEW DROP ;
> : USEITEM HWND 99 GetDlgItem MH ! ;
>
> : OnInitDlg USEITEM PROJECTION CUBE RENDER VIEW_KEY ;

I think 'split' is not 'factor': for me the final result is
no more readable. But to split the original definition can be
interesting to reuse the parts somewhere in the program,
or to reduce the size of a too big definition.

Seems to be a very subjective topic.

Thanks again,
Charles

----------------------------------------------------------------------
sftalk_at_forth.com The SwiftForth programming discussion email list
To unsubscribe, send subject "unsubscribe sftalk" to listar_at_forth.com
For help with listar commands, send subject "help" to listar_at_forth.com
Archives are located at http://www.forth.com/sftalk -- check them out!
Search the archives! Visit http://www.forth.com/search for details.
Received on Fri Dec 06 2002 - 02:50:35 PST