PSARC/2008/315 - autogen and guile
steve xue
Steve.Xue at sun.com
Mon May 12 21:44:05 PDT 2008
Halton Huo wrote:
> 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?
>
Following is the 3 commands output:
[root at steve-xue scripts] > guile-config
Usage:
guile-config --version - show installed script and Guile version
guile-config --help - show usage info (this message)
guile-config --help SUBCOMMAND - show help for SUBCOMMAND
guile-config link - print libraries to link with
guile-config compile - print C compiler flags to compile with
guile-config info [VAR] - print Guile build directories
[root at steve-xue scripts] > guile-tools
api-diff lint scan-api
autofrisk PROGRAM
snarf-check-and-output-texi
display-commentary punify
snarf-guile-m4-docs
doc-snarf read-rfc822
summarize-guile-TODO
frisk read-scheme-source use2dot
generate-autoload read-text-outline
[root at steve-xue scripts] > guile-snarf
/* cpp arguments: */
gcc: no input files
Maybe we need man pages for 'guile-tools' and 'guile-snarf',
guile-config's function is very obvious
> 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?
>
For the readline* , they are all symbol link, because currently Solaris
do not have any static readline library shipped
I think I should remove these symboe links.
For
/usr/lib/pkgconfig/guile-1.8.pc
I didn't see it in 1.8.4, I am not sure if it can only be gotten from
1.8.5:)
> -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
>>
>>
>>
>>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.opensolaris.org/pipermail/opensolaris-arc/attachments/20080513/b186d62b/attachment.html>
More information about the opensolaris-arc
mailing list