Man Pages
Are the man pages for the specific openpkg software online somewhere on the web site? It would be nice if they were. When we build our software currently the man pages all fail to properly build for some reason. It's a low priority for us to resolve but it would be nice if the man pages for openpkg, openpkg-tools and the other packages that are specific to openpkg were online. I can't seem to find them on the site if they are. -- David M. Fetter - UNIX Systems Administrator Portland State University - www.oit.pdx.edu signature.asc Description: This is a digitally signed message part
Re: Man Pages
On Tue, May 08, 2007, David M. Fetter wrote: Are the man pages for the specific openpkg software online somewhere on the web site? It would be nice if they were. When we build our software currently the man pages all fail to properly build for some reason. It's a low priority for us to resolve but it would be nice if the man pages for openpkg, openpkg-tools and the other packages that are specific to openpkg were online. I can't seem to find them on the site if they are. We currently don't have the manpages online. In case someone wants to investigate on this: In order to display all manpages of all packages, we would either need an OpenPKG instance with all packages installed (which is not possible anyway) or at least have all packages staying around in unpacked format (which we currently do not have, too). Additionally one needs a man to html formatter and a small wrapper CGI. I think there is rman which we use at FreeBSD.org... Ralf S. Engelschall [EMAIL PROTECTED] www.engelschall.com __ OpenPKG http://openpkg.org User Communication List openpkg-users@openpkg.org
Re: Man Pages
I don't mean for all packages. I just mean the openpkg specific packages. The software/tools that have been developed in-house for use in the openpkg world. That should only be 4 or 5 man pages total. It would be a nice addition to list under the Documentation area. On Tue, 2007-05-08 at 19:51 +0200, Ralf S. Engelschall wrote: On Tue, May 08, 2007, David M. Fetter wrote: Are the man pages for the specific openpkg software online somewhere on the web site? It would be nice if they were. When we build our software currently the man pages all fail to properly build for some reason. It's a low priority for us to resolve but it would be nice if the man pages for openpkg, openpkg-tools and the other packages that are specific to openpkg were online. I can't seem to find them on the site if they are. We currently don't have the manpages online. In case someone wants to investigate on this: In order to display all manpages of all packages, we would either need an OpenPKG instance with all packages installed (which is not possible anyway) or at least have all packages staying around in unpacked format (which we currently do not have, too). Additionally one needs a man to html formatter and a small wrapper CGI. I think there is rman which we use at FreeBSD.org... Ralf S. Engelschall [EMAIL PROTECTED] www.engelschall.com __ OpenPKG http://openpkg.org User Communication List openpkg-users@openpkg.org -- David M. Fetter - UNIX Systems Administrator Portland State University - www.oit.pdx.edu signature.asc Description: This is a digitally signed message part
perl module man pages
Hello, all.
First, kudos on creating such a comprehensive system for portably
building and installing unix software. I've found it incredibly useful
for my day job, as well as for some personal projects at home. I can't
say enough good things about the system, as several of my friends and
coworkers will attest. :-)
Anyway...I'm in the process of writing spec files for various
applications I'm installing inside OpenPKG. One of the is a perl module
with a man page, for which I would like to have the man page installed.
I noticed that when I called Makefile.PL outside of OpenPKG, the man
page was created and installed properly, but when I installed via the
perl-openpkg script, the man page was not installed. After further
investigation, I think I have identified the reason:
a chunk of perl-openpkg:
--
# STEP: 4. install
if (grep { eq install } @steps_run) {
verbose(step 4: install);
# sanity check
if (not -f Makefile) {
die file \Makefile\ not found in working directory;
}
# determine make(1) command and flags
my = ;
=~ s|\n+$||s;
my = PERL= FULLPERL=;
# execute make(1)
runcmd( pure_install);
}
--
Perl-openpkg calls the 'pure_install' target instead of the 'install'
target, in the module's generated Makefile. As far as I can tell, the
only difference between these targets is that 'pure_install' does not
install documentation. This seems like it was a conscious decision...if
you don't mind, may I ask what the rationale was? Is this something
that should be changed in perl-openpkg, or is it better for me to
manually call pod2man in my spec file?
Thanks!
--
Larry Lansing
__
The OpenPKG Projectwww.openpkg.org
User Communication List openpkg-users@openpkg.org
Re: perl module man pages
Ralf S. Engelschall wrote: The reason simply is that with our myriad of Perl modules in the various perl-xxx packages the prefix/man/ area would be totally _flooded_ with _copies_ of files A-ha! I knew there must be a good reason. Well, I think we should keep perl-openpkg as is or at maximum add an option which allows it to use make install instead of make pure_install if wished. But unless we have more packages which need this option I think it would be best to simply run pod2man(1) in your *.spec file... Works for me. Thanks! -- Larry Lansing __ The OpenPKG Projectwww.openpkg.org User Communication List openpkg-users@openpkg.org
Re: Scrambled man pages
On Tue, Jul 26, 2005, Doug Summers wrote:
This seems to be platform-independent...
When trying to display OpenPKG man pages most of them work great. Here
is my output for 'openpkg man gcc:
...
For rpm it's a scrambled mess:
Red Hat Linux RPM(8)
ESC[1mNAMEESC[0m
rpm - RPM Package Manager
ESC[1mSYNOPSISESC[0m
ESC[1mQUERYING AND VERIFYING PACKAGES:ESC[0m
ESC[1mrpm ESC[22m{ESC[1m-q|--queryESC[22m}
[ESC[1mselect-optionsESC[22m] [
ESC[1mquery-optionsESC[22m]
My SWAG on this is the setting of your PAGER environment variable. I think
the default for OpenPKG is ``less -E -r'' where the -E automatically quits
at the end of the viewing (which I *HATE* and turn off), and the -r seems
to be the trick to get less to view man pages correctly.
Bill
--
INTERNET: [EMAIL PROTECTED] Bill Campbell; Celestial Software LLC
UUCP: camco!bill PO Box 820; 6641 E. Mercer Way
FAX:(206) 232-9186 Mercer Island, WA 98040-0820; (206) 236-1676
URL: http://www.celestial.com/
To say that UNIX is doomed is pretty rabid, OS/2 will certainly play a role,
but you don't build a hundred million instructions per second multiprocessor
micro and then try to run it on OS/2. I mean, get serious.
-- William Zachmann, International Data Corp
__
The OpenPKG Projectwww.openpkg.org
User Communication List openpkg-users@openpkg.org
Re: man pages for shtool
On Thu, Jan 15, 2004, Christopher Chan wrote: Is there any man page or other documentation for shtool other then the script itself? Yes. If you: o Installed the OpenPKG shtool package, then shtool.1 is found in /yourprefix/man/man1/shtool.1 o Installed OSSP shtool (without OpenPKG), then shtool.1 is found wherever you specified during configuration: $ ./configure --help | grep mandir $ --mandir=DIR man documentation [PREFIX/man] Only if you've never installed shtool will you have no documentation. OpenPKG copies only the 'shtool' binary to its lib/openpkg directory for internal use. It does not copy 'shtoolize' or any other files (including docs). Likewise for tar, curl, gzip, bash... So if you have indeed installed shtool, it should be as easy as: $ man shtool $ man shtoolize Set $MANDIR to the path of your 'shtool.1' if this doesn't work. -- [EMAIL PROTECTED] Development Team, Operations Northern Europe Cable Wireless Telecommunications Services GmbH pgp0.pgp Description: PGP signature
Re: man pages for shtool
On Thu, Jan 15, 2004, Christopher Chan wrote: Is there any man page or other documentation for shtool other then the script itself? Trying to understand more about it so I know when and where are the best places to use it. Well, install the shtool package and run man shtool. Although OpenPKG-CURRENT's current bootstrap package contains a newer snapshot version of GNU shtool, the documentation in the shtool package still applies fine. The same for all other tools like GNU tar etc. which are contained in the bootstrap package. GNU shtool is no exception here. Ralf S. Engelschall [EMAIL PROTECTED] www.engelschall.com __ The OpenPKG Projectwww.openpkg.org User Communication List [EMAIL PROTECTED]
man pages for shtool
Is there any man page or other documentation for shtool other then the script itself? Trying to understand more about it so I know when and where are the best places to use it. Christopher Chan email: [EMAIL PROTECTED] work: 650-561-0227
