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>
