hext Files

hext	README		2013.AUG.14 [gsh]

Author(s):	polarysekt, gsh
Language:	C
License:	LGPL 3

::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
::NOTES
    + The project root makefile is not yet operational, 
	see ALPHA-DEBUGGING section

    + The make clean will remove only object files and binaries
	(will NOT remove any temporary or backup files)
	
    + The rcs_co and rcs_ci have locking enabled to user "evan"

    
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
:: INFO - ALPHA-DEBUGGING ::

  REQUIREMENTS:
    
  NOTES:
    Depending on the storage medium for this project, shell scripts (.sh) may
    require the executable bit set, which is not supported on all mediums.
      $ chmod +x <filename>
    
  All the debugging commands are in src/ during ALPHA phase
    $ cd src/

  RCS checkout:
    $ rcs_co.sh

  BUILD:

    DEBUG:
      $ make clean && make hext_debug
      $ ./hext_debug
  
    RELEASE:
      $ make clean && make
      $ ./hext
      
  RCS checkin:
    $ rcs_ci.sh


::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
:: INFO - END-USERS ::

  NOTE:: the ALPHA and BETA debugging phases are not intended for end-users.

  Getting Started:
    Configure Hext:
      the hext project is distributed as source.
      before it can be run, it must be compiled.
      before it can be compiled, it must be configured.
      
      **ASSUME** this working version has already been deployed by maintainer.

      The variable CC should refer to the C compiler to be used.
      
    CONFIGURATION::HEXT
      $ make config
	or one of the variants:
	  $ make menuconfig
	  $ make xconfig
	  $ make gtkconfig
	  $ make mswinconfig
	  $ make qtconfig


    menuconfig:		requires libcurses
    xconfig:		required libx
    gtkconfig:		requires libgtk-dev
    mswinconfig:	requires libmswin
    qtconfig:		requires libqt

    
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
:: INFO - DEVELOPERS ::

  Before a makefile is available, the package must be "deployed"

::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
:: INFO - MAINTAINERS ::

  Maintainers control the entire project, pre-deployment

  
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
                                     Copyright(c) 2013, Geoffrey Hadler, kb3c.uX
                                                            All rights reserved. 
                                          See COPYING for an up-to-date license.