???Hi Steve,

AFAIK, binaries under /usr/bin should have man pages. For autogen, ???man
pages are okay. For guile, Only found man page for guile, how about
other three: guile-snarf, guile-config, ???guile-tools?

And need these man page files listed in the "???Exported Interfaces" form?

When I build guile 1.8.5, I got four more files
/usr/lib/libguilereadline-v-17.so
???/usr/lib/libguilereadline-v-17.so.17
???/usr/lib/libguilereadline-v-17.so.17.0.3
/usr/lib/pkgconfig/guile-1.8.pc

Do you remove them in purpose?

-Halton.

On Tue, 2008-05-13 at 11:04 +0800, steve xue wrote:
> Halton Huo wrote:
> > ??????Give a review on this fast track, comments:
> >
> > ??????1. typo
> >   ??????/usr/bin/guile-confi should be /usr/bin/guile-config
> > 2. no man pages for SUNWguile
> >    community do not have, only have info
> > 3. no man pages for SUNWautogen
> >    ??????community have
> >
> > -
> Thanks Halton!
> 
> I re-sent my materials in this mail, man pages are attached.
> plain text document attachment (autogen_fasttrack.txt)
> Summary
> =======
>    Autogen[1] is a tool designed to simplify the creation and maintenance of
>    programs that contain large amounts of repetitious text. It is especially
>    valuable in programs that have several blocks of text that must be kept
>    synchronized.
> 
>    This utility can also be called a code generator, which are programs that
>    automatically generate high level code (e.g. C, C++, C#, Java, Perl, 
> Python,
>    Ruby, etc.).  These tools range in size and complexity from simple code
>    parsers to fully featured class and tier builders. 
> 
>    AutoOpts is bundled with AutoGen. It is a tool that virtually eliminates 
>    the hassle of processing options and keeping man pages, info docs and 
> usage 
>    text up to date. This package allows you to specify several program 
> attributes,
>    up to a hundred option types and many option attributes. From this, 
>    it then produces all the code necessary to parse and handle the command 
> line 
>    and configuration file options, and the documentation that should go with 
>    your program as well.
>  
>    AutoGen/AutoOpts is a two-part project that serves two separate purposes
>    and are inextricably intertwined.
> 
>    Because the implementation of Autogen used guile[2](GNU's extension
>    language) and guile is not available now in SFW consolidation, so we decide
>    to merge guile porting work together into this case.
> 
>    Guile[2] is a library designed to help programmers create flexible
>    applications.  Using Guile in an application allows programmers to write
>    plug-ins or modules so the application fit their needs.
>  
>    Autogen-5.9 will be integrated into the SFW consolidation as part of this
>    proposal, and will be installed as SUNWautogen.
> 
>    Guile-1.8.4 will be integrated into the SFW consolidation as part of this
>    proposal, and will be installed as SUNWguile
> 
>    This project requests a minor release binding. 
> 
> 
> Dependencies
> ============
> 
>    libltdl            ltdl - GNU libtool dlopen wrapper               
> PSARC/2007/557
>    libgmp     GNU Multiple Precision Arithmetic Library       PSARC/2008/166
> 
> 
> Interfaces
> ==========
> 
>    (1) Guile related:
> 
>    Exported Interfaces                Classification  Comment
>    -------------------                --------------  -------
>    SUNWguile                  Uncommitted     Package
>    /usr/bin/guile             Uncommitted     Command
>    /usr/bin/guile-snarf               Uncommitted     Command
>    /usr/bin/guile-config      Uncommitted     Command
>    /usr/bin/guile-tools               Uncommitted     Command
> 
>    /usr/lib/libguile.so       Uncommitted     Guile library symbol link
>    /usr/lib/libguile.so.17.1.2        Uncommitted     Guile library
> 
>    /usr/lib/libguile-srfi-srfi-1-v-3.so.3.0.1 
>                               Uncommitted     Guile srfi 1 implementation 
> library
>    /usr/lib/libguile-srfi-srfi-1-v-3.so
>                               Uncommitted     symbol link to 
>                                               Guile srfi 1 implementation 
> library
> 
>    /usr/lib/libguile-srfi-srfi-4-v-3.so.3.0.1 
>                               Uncommitted     Guile srfi 4 implementation 
> library
>    /usr/lib/libguile-srfi-srfi-4-v-3.so
>                               Uncommitted     symbol link to 
>                                               Guile srfi 4 implementation 
> library
> 
>    /usr/lib/libguile-srfi-srfi-13-14-v-3.so.3.0.1
>                               Uncommitted     Guile srfi 13 and 14 
> implementation library
>    /usr/lib/libguile-srfi-srfi-13-14-v-3.so
>                               Uncommitted     symbol link to 
>                                               Guile srfi 13 and 14 
> implementation library
> 
>    /usr/lib/libguile-srfi-srfi-60-v-2.so.2.0.2
>                               Uncommitted     Guile srfi 60 implementation 
> library
>    /usr/lib/libguile-srfi-srfi-60-v-2.so
>                               Uncommitted     symbol link to 
>                                               Guile srfi 60 implementation 
> library
> 
>    /usr/share/guile/          Project Private Scheme modules
> 
>    /usr/include/libguile.h    Uncommitted     Header files
>    /usr/include/libguile      Uncommitted     Header files
>    /usr/include/guile/                Uncommitted     Header files
> 
>    Imported Interfaces                Classification  Comment
>    -------------------                --------------  -------
>    /usr/lib/libltdl.so                Uncommitted     PSARC/2007/557
>    /usr/lib/libgmp.so         Committed       PSARC/2008/166
> 
>    (2) Autogen related:
> 
>    Exported Interfaces                Classification  Comment
>    -------------------                --------------  -------
>    SUNWautogen                        Uncommitted     Package
>    /usr/bin/autogen           Uncommitted     Command
>    /usr/bin/autoopts-config   Uncommitted     Command
>    /usr/bin/columns           Uncommitted     Command
>    /usr/bin/getdefs           Uncommitted     Command
>    /usr/bin/xml2ag            Uncommitted     Command
> 
>    /usr/lib/libguileopts.so   Uncommitted     Libguileopts library symbol
>                                               link
>    /usr/lib/libguileopts.so.0.0.1
>                               Uncommitted     Libguileopts library
> 
>    /usr/share/autogen/                Uncommitted     Templates can be used 
> as autogen command arguments
> 
>    /usr/lib/libopts.so.25.3.0   
>                               Uncommitted     Library used by libguileopts.so 
> and autogen
> 
>    /usr/include/autoopts/     Uncommitted     Header files
> 
>    Imported Interfaces                Classification  Comment
>    -------------------                --------------  -------
>    /usr/lib/libguile.so       Uncommitted     Guile library symbol link
> 
> 
> Reference Documents
> ===================
>    [1] http://www.gnu.org/software/autogen/
>    [2] http://www.gnu.org/software/guile/
> 
>    RFE ID# 6672584 for autogen
>    RFE ID# 6672583 for guile
> plain text document attachment (guile.1.txt)
> 
> 
> User Commands                                            guile(1)
> 
> 
> 
> NAME
>      guile - a library designed to help programmers create flexi-
>      ble applications
> 
> SYNOPSIS
>      /usr/bin/guile [OPTION]...
> 
> DESCRIPTION
>      Using Guile in an application allows  programmers  to  write
>      plug-ins,  or modules (there are many names, but the concept
>      is essentially the same) and users to use them  to  have  an
>      application fit their needs.
> 
>      For additional information on using guile, see the Info for-
>      mat documentation by running the following command from your
>      shell:
>           /usr/sfw/bin/info guile
> 
>      guile is provided for developers who are working on software
>      that  has  already  adopted  it.   However, it is not recom-
>      mended that guile be used when developing new software  pro-
>      jects.
> 
> ATTRIBUTES
>      See attributes(5) for descriptions of the  following  attri-
>      butes:
> 
>      _______________________________________
>     |   ATTRIBUTE TYPE   |  ATTRIBUTE VALUE|
>     |_______________________________________
>     | Availability       |  SUNWguile      |
>     |_______________________________________
>     | Interface Stability|  Uncommitted    |
>     |____________________|_________________|
> 
> NOTES
>      Source for guile is available on http://opensolaris.org.
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> SunOS 5.10          Last change: 08 Mar 2008                    1
> 
> 
> 


Reply via email to