[Global-commit] global/htags bless.sh.tmpl global.cgi.tmpl.in h...

[Shigio YAMAGUCHI]

CVSROOT:        /sources/global
Module name:    global
Changes by:     Shigio YAMAGUCHI <shigio>       10/06/27 22:51:07

Modified files:
        htags          : bless.sh.tmpl global.cgi.tmpl.in htags.c 
                         manual.in src2html.c 

Log message:
        Changed the mechanism for center CGI.
        This is a copy of the RFC submitted on the mailing list:
        
        When the -S option is specified, current htags use path name
        as a internal key. But but it is not preferable. I will change
        the mechanism to use a unique key specified by user to conceal
        real path name.
        
        1. New htags requires a unique key as the parameter of the -S option.
           (incompatible change)
        
        2. Htags makes a file whose name is the key in shared area, and
           put the path of the HTML directory in it.
        
        3. To make the file name unique, a key that already exists
           is not allowed without --over-write option.
        
        [in /var/src]
        $ htags ... -S key1
                       ====
                         |
                         +----------------+-----+
                                          v     |               
        [/usr/local/share/gtags/sitekeys/key1]  |
        +--------------------------------       |
        |/var/src/HTML                          |     ... (2)
                                                |
        [/var/src/HTML/index.html]              |
        +--------------------------------       |
        |...                                    v
        |<input type='hidden' name='id' value='key1'> ... (1)
                                               ====
        
        The center CGI script can know the path of HTML directory by the 
following
        method.
        
        (1) get a unique key from the variable 'id'
                => 'key1'
        (2) read directory name from '/usr/local/share/gtags/sitekeys/' + 'key1'
                => '/var/src/HTML'
        
        This mechanism conceals the real path name.
        Though a unique key can be calculated  automatically, I don't think
        it is preferable because many keys are generated without bounds.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/global/htags/bless.sh.tmpl?cvsroot=global&r1=1.4&r2=1.5
http://cvs.savannah.gnu.org/viewcvs/global/htags/global.cgi.tmpl.in?cvsroot=global&r1=1.24&r2=1.25
http://cvs.savannah.gnu.org/viewcvs/global/htags/htags.c?cvsroot=global&r1=1.155&r2=1.156
http://cvs.savannah.gnu.org/viewcvs/global/htags/manual.in?cvsroot=global&r1=1.121&r2=1.122
http://cvs.savannah.gnu.org/viewcvs/global/htags/src2html.c?cvsroot=global&r1=1.71&r2=1.72