jp-man-1.1j/ 40755 5777 310 0 7311121606 11356 5ustar tkumanosltjp-man-1.1j/COPYING100644 5777 310 43076 6437733101 12547 0ustar tkumanoslt GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 675 Mass Ave, Cambridge, MA 02139, USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) You can apply it to your programs, too. When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for this service if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs; and that you know you can do these things. To protect your rights, we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Program specifies a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. END OF TERMS AND CONDITIONS Appendix: How to Apply These Terms to Your New Programs If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms. To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. Copyright (C) 19yy This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) 19yy name of author Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details. The hypothetical commands `show w' and `show c' should show the appropriate parts of the General Public License. Of course, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. , 1 April 1989 Ty Coon, President of Vice This General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Library General Public License instead of this License. jp-man-1.1j/Makefile100644 5777 310 454 6437733234 13114 0ustar tkumanoslt# Master Makefile for man, manpath, apropos, whatis, and makewhatis # # You may distribute under the terms of the GNU General Public # License as specified in the README file that comes with the man 1.0 # distribution. # SUBDIR = lib man manpath apropos makewhatis catman .include jp-man-1.1j/Makefile.inc100644 5777 310 1577 7230542702 13701 0ustar tkumanoslt# # Set a bunch of things to hardcoded paths so that we don't accidently # pick up a user's own version of some utility and hose ourselves. # BINDIR= ${PREFIX}/bin MANDIR= ${PREFIX}/man/ja/man EMANDIR= ${PREFIX}/man/man libdir= ${PREFIX}/etc libexecdir= ${PREFIX}/libexec bindir= ${BINDIR} pager= jless -s manpath_config_file= /etc/manpath.config troff= ${bindir}/groff -S -mandoc nroff= ${bindir}/groff -S -Wall -Tnippon -mtty-char -mandoc apropos= ${bindir}/japropos whatis= ${bindir}/jwhatis neqn= ${bindir}/geqn -Tascii tbl= ${bindir}/gtbl col= vgrind= refer= ${bindir}/refer grap= # no grap pic= ${bindir}/gpic zcat= ${GZCAT} compress= ${GZIP_CMD} compext= .gz .if exists(${.OBJDIR}/../lib) LIBDESTDIR= ${.OBJDIR}/../lib .else LIBDESTDIR= ${.CURDIR}/../lib .endif LIBMAN= ${LIBDESTDIR}/libman.a jp-man-1.1j/README100644 5777 310 11070 6437733325 12371 0ustar tkumanosltREADME file for man(1). This is a replacement for Un*x man(1), apropos(1), whatis(1), and manpath(1). It has all kinds of neat features that other versions of man don't, including support for multiple man page directory trees, preformatted man pages, and troff. It is provided without any warranty whatever. I hope you find it useful. This program is not a GNU product but it is distributed under the terms of the GNU copyleft which is described in the file COPYING. There is a solution written in perl which is probably superior in every way, but, like me, you may prefer this one anyway. :-) If you compile with support for preformatted man pages, man(1) will try to update the preformatted page if the man page source is newer. If you compile with support for troff, you can say things like `man -t foo | psdit > foo.ps' and have fabulous printed documentation as well. I have resisted the temptation to handle all the bizarre ways various vendors have of organizing man pages. This version of man assumes that directory trees have the structure: .../man /manSect /foo.Sect* ... /catSect /foo.Sect* ... where Sect is some number or string and should be listed in the set of sections to be searched. It is not necessary to have both the cat* and man* subdirectories, but you must have at least one. :-) INSTALLATION 1. Run configure. This will grope around your system a bit and then ask you a number of questions. It will create a Makefile from the file Makefile.in, and a config.h file from config.h.in. You may have to do some fine tuning to get things to work exactly right on your system. If you do, I'd like to know what changes you had to make to get things working. 2. Edit the manpath.config file. This determines the system-wide mappings for bin directories and man page directories. 3. Do a `make all', try it out, and then if you're happy with that, do a `make install'. You don't need to be root to use this set of programs. 4. Install the whatis database(s) by running makewhatis. If you want to keep things absolutely current, you'll need to run this whenever you add new man pages. You might want to add an entry in your crontab. BUGS If you find one of these, please tell me about it. If you have a fix, that's even better. If not, I can't guarantee that I'll fix it, but I would like to know about them. John Eaton jwe@che.utexas.edu Department of Chemical Engineering The University of Texas at Austin Austin, Texas 78712 CHANGES Partial list of changes since version 1.0: Installation made easier (this was the intent anyway) with the introduction of a configure script. Commands like `man 3f intro' handled properly when the name of the file we want is something like .../man3/intro.3f. Man can now run set uid to a special user so formatted man pages don't have to be world writable. Man now works with compressed (.Z) frozen (.F) and yabba (.Y) cat files. Frozen files are compressed files using freeze/melt, some combination of LZW and tree coding. Sources for it came out on comp.sources.misc or alt.sources or ... a few months ago. Yabba files are compressed using yabba/unyabba, a data compression scheme posted to alt.sources by Dan Bernstein. Man now uses a more reasonable default for the search order: 1, n, l, 6, 8, 2, 3, 4, 5, 7, p, o Man now allows for user-definable section search order via -S or MANSECT. Glob.c can work even if you don't have alloca, and works properly on Suns with the Sun C compiler. There is now a way to automatically to run preprocessors like the Sun man program. The first line of the man page indicates which preprocessors should be run: If the first line is a string of the form: '\" X where X is separated from the the `"' by a single SPACE and consists of any combination of characters in the following list, man pipes its input to troff(1) or nroff(1) through the corresponding preprocessors. e eqn(1), or neqn for nroff g grap(1) p pic(1) r refer(1) t tbl(1), and col(1V) for nroff v vgrind(1) Preprocessors may also be set on the command line with -p or from the environment with MANROFFSEQ. The tbl preprocessor is run by default. Manpath now stat()'s the directories in MANPATH to avoid including directories that don't exist. The output of apropos and whatis are now piped through PAGER. There is a new option to show where you would find a man page (-w option) and in what order (-w with -a). jp-man-1.1j/TODO100644 5777 310 11027 6437733345 12205 0ustar tkumanosltThings that would be nice but aren't really necessary: 0. Update the documentation. XX Come up with an easier way to install this thing. There are now lots of options and dependent flags to set. Should I worry too much about this? XX Properly handle commands like `man 3f intro' when the name of the file we want is something like .../man3/intro.3f. The way this is done right now seems sort of kludgey but it mostly works. See man.c for details. 2. Malloc everything instead of having fixed limits... Or at least check the limits everywhere. If you're paranoid about this, make the limits big (famous last words: really, there aren't that many things that could go wrong :-). 3. Try to do a little better job of memory management. There are a lot of little temporary strings that are malloc'd and never freed. This is probably ok for a standalone program but not so good if you wanted to call man() from another program. XX Come up with a clear view of the cat directory file permissions problem. What's a good solution, other than having man run setuid to some special user? (Make directories writable by all, cat files 666.) XX Allow a compile time option that makes man run setuid to some other user that owns all the cat pages, so that they don't have to be world writable. XX Allow man to deal with compressed (.Z) frozen (.F) and yabba (.Y) cat files. Frozen files are compressed files using freeze/melt, some combination of LZW and tree coding. Sources for it came out on comp.sources.misc or alt.sources or ... a few months ago. Yabba files are compressed using yabba/unyabba, a data compression scheme posted to alt.sources by Dan Bernstein. XX Choose a more reasonable default for the search order. Perhaps this: 1, n, l, 6, 8, 2, 3, 4, 5, 7, p, o XX Fix glob.c so it doesn't need alloca, and/or fix it so that it can work on a Sun: #ifdef __GNUC__ #define alloca __builtin_alloca #else /* !__GNUC__ */ #ifdef sparc #include #endif /* sparc */ #endif /* __GNUC__ */ XX Add some way to automatically to run preprocessors. The Sun man program has a convention that the first line of the man page can indicate which preprocessors should be run. Here's an excerpt from its man page: Preprocessing Manual Pages If the first line is a string of the form: '\" X where X is separated from the the `"' by a single SPACE and consists of any combination of characters in the following list, man pipes its input to troff(1) or nroff(1) through the corresponding preprocessors. e eqn(1), or neqn for nroff r refer(1) t tbl(1), and col(1V) for nroff v vgrind(1) If eqn or neqn is invoked, it will automatically read the file /usr/pub/eqnchar (see eqnchar(7)). XX Have manpath stat() the directories in MANPATH to avoid including directories that don't exist. Some versions of man and whatis complain when the directories (like /usr/new/man) don't exist. XX Pipe the output of apropos and whatis through a pager. XX I've been using your man(1) package for a while now and I ran into a problem with the X man pages that use tbl commands. Is it possible to configure your man(1) package to use a general command string. For example, a user could set an environment variable: setenv ROFFLINE 'pic $* | tbl | nroff -man' 13. Fix makewhatis so that it can handle stuff like this (from the Motif 1.1 man pages): .TH XmRowColumn 3X "" "" "" "" .SH NAME .mc | \fBXmRowColumn \(em the RowColumn widget class.\fP .mc .iX "XmRowColumn" .iX "widget class" "RowColumn" .sp 1 .SH SYNOPSIS 14. Consider changing the format of the awk command's printf to use "%s" instead of the standard 20.20s to accomodate the extra long file names used by Motif. Maybe there's a better way to handle this? 15. Add ability to run man on a local file 16. Handle per-tree tmac macros XX Allow user-definable section search order via -S or $MANSECT. Thus programmers can get stty(3) before stty(1). XX Show all the places you would find a man page (-w option) and in what order. 19. Support for multi-char sections like man1m/*.1m or manavs/*.avs (can I have a section that doesn't start with a numeral?) 20. Implement man -K for regexp apropos 21. An option to grep through all the man pages in $MANPATH jp-man-1.1j/apropos/ 40755 5777 310 0 7311135557 13053 5ustar tkumanosltjp-man-1.1j/apropos/Makefile100644 5777 310 3241 6442500611 14577 0ustar tkumanoslt.if exists(${.CURDIR}/obj) MAN1= ${.CURDIR}/obj/japropos.1 EMAN1= ${.CURDIR}/obj/japropos.1.eng.gz TARG= ${.CURDIR}/obj/japropos .else MAN1= ${.CURDIR}/japropos.1 EMAN1= ${.CURDIR}/japropos.1.eng.gz TARG= ${.CURDIR}/japropos .endif MLINKS= japropos.1 jwhatis.1 MANDEPEND= ${MAN1} CLEANFILES+= ${TARG} ${MAN1} ${EMAN1} all: ${TARG} ${MAN1} ${EMAN1} depend rcsfreeze tags all: @echo -n ${TARG}: ${.CURDIR}/apropos.sh sed -e 's,%libdir%,${libdir},' -e 's,%bindir%,${bindir},' \ -e 's,%pager%,${pager},' \ ${.CURDIR}/apropos.sh > ${.TARGET} ${MAN1}: ${.CURDIR}/japropos.man sed -e 's,%libdir%,${libdir},' -e 's,%bindir%,${bindir},' \ -e 's,%pager%,${pager},' -e 's,%troff%,${troff},' \ -e 's,%manpath_config_file%,${manpath_config_file},' \ ${.CURDIR}/japropos.man > ${.TARGET} ${EMAN1}: ${.CURDIR}/japropos.man.eng sed -e 's,%libdir%,${libdir},' -e 's,%bindir%,${bindir},' \ -e 's,%pager%,${pager},' -e 's,%troff%,${troff},' \ -e 's,%manpath_config_file%,${manpath_config_file},' \ ${.CURDIR}/japropos.man.eng | \ ${compress} > ${.TARGET} install: ${TARG} maninstall after_maninstall ${INSTALL} -c -o bin -g bin -m 555 ${TARG} ${DESTDIR}${BINDIR} ln -f ${DESTDIR}${BINDIR}/japropos ${DESTDIR}${BINDIR}/jwhatis .if !defined(NOMAN) after_maninstall: ${EMAN1} ${INSTALL} -c -o bin -g bin -m 444 ${EMAN1} \ ${DESTDIR}${EMANDIR}1/japropos.1.gz ln -f ${DESTDIR}${EMANDIR}1/japropos.1.gz \ ${DESTDIR}${EMANDIR}1/jwhatis.1.gz .else after_maninstall: .endif .include "../Makefile.inc" .if make(maninstall) || make(install) .if !defined(NOMAN) .include .elif !target(maninstall) maninstall: .endif .endif .include jp-man-1.1j/apropos/apropos.sh100644 5777 310 5465 7311122704 15167 0ustar tkumanoslt#!/bin/sh # # apropos -- search the whatis database for keywords. # # Copyright (c) February 1996 Wolfram Schneider . Berlin. # Copyright (c) 1990, 1991, John W. Eaton. # # You may distribute under the terms of the GNU General Public # License as specified in the README file that comes with the man # distribution. # # John W. Eaton # jwe@che.utexas.edu # Department of Chemical Engineering # The University of Texas at Austin # Austin, Texas 78712 # # $FreeBSD: src/gnu/usr.bin/man/apropos/apropos.sh,v 1.14 2001/03/30 10:44:29 wosch Exp $ # # Japanized by # Copyright (c) KUMANO, Tadashi , 1996, 1997, 1998, # Copyright (c) FreeBSD jp-man project , 1998, # which is a study toward the multilingual enhancement. # (version 1.1g 1998/03/28) # PATH=/usr/local/bin:/bin:/usr/bin:$PATH db=whatis # name of whatis data base grepopt='' # man -k complain if exit_nomatch=1 and no keyword matched : ${exit_nomatch=0} exit_error=2 # argument test case $# in 0) echo "usage: `basename $0` keyword ..." >&2 exit $exit_error ;; esac case "$0" in *whatis) grepopt='-w';; # run as jwhatis(1) *) grepopt='';; # otherwise run as japropos(1) esac # test manpath # (JP: use `jmanpath') # (JP: if manpath is null, use /usr/local/man also) manpath=`%bindir%/jmanpath -q | tr : '\040'` case X"$manpath" in X) echo "`basename $0`: manpath is null, use \"/usr/share/man:/usr/local/man\"" >&2 manpath="/usr/share/man\040/usr/local/man" ;; esac # reset $PAGER if $PAGER is empty case X"$PAGER" in X) PAGER="%pager%" ;; esac # (JP: get current LOCALE) if [ X"$LC_ALL" != X ] then LOCALE="$LC_ALL" elif [ X"$LC_CTYPE" != X ] then LOCALE="$LC_CTYPE" elif [ X"$LANG" != X ] then LOCALE="$LANG" else LOCALE="" fi # # search for existing */whatis databases mandir='' if [ "$LOCALE" != "" ] then locale_dir="$LOCALE "`echo $LOCALE|sed -n -e 's/^\(.._..\)\..*/\1/p'`" "`echo $LOCALE|sed -n -e 's/^\(..\)_.*/\1/p'` for l in $locale_dir do for d in $manpath do if [ -f "$d/$l/$db" -a -r "$d/$l/$db" ] then mandir="$mandir $d/$l/$db" fi done done fi for d in $manpath do if [ -f "$d/$db" -a -r "$d/$db" ] then mandir="$mandir $d/$db" fi done case X"$mandir" in X) echo "`basename $0`: no whatis databases in $manpath" >&2 exit $exit_error esac for manpage do if grep -hi $grepopt -- "$manpage" $mandir; then : else echo "$manpage: nothing appropriate" fi done | ( # start $PAGER only if we find a manual page while read line do case $line in # collect error(s) *": nothing appropriate") line2="$line2$line\n";; # matched line or EOF *) break;; esac done # nothing found, exit if [ -z "$line" -a ! -z "$line2" ]; then printf -- "$line2" exit $exit_nomatch else ( printf -- "$line2"; echo "$line"; cat ) | $PAGER fi ) jp-man-1.1j/apropos/japropos.man.eng100644 5777 310 2465 7311134100 16240 0ustar tkumanoslt.\" Man page for apropos and whatis .\" .\" Copyright (c) 1990, 1991, John W. Eaton. .\" .\" You may distribute under the terms of the GNU General Public .\" License as specified in the README file that comes with the man 1.0 .\" distribution. .\" .\" John W. Eaton .\" jwe@che.utexas.edu .\" Department of Chemical Engineering .\" The University of Texas at Austin .\" Austin, Texas 78712 .\" \" $FreeBSD: src/gnu/usr.bin/man/apropos/apropos.man,v 1.8 2000/12/11 15:10:52 ru Exp $ .\" .\" Japanized by .\" Copyright (c) KUMANO, Tadashi , 1996-2001, .\" which is a study toward the multilingual enhancement. .\" (version 1.1j 2001/06/11) .\" .Dd June 11, 2001 .Dt JAPROPOS 1 .Os .Sh NAME .Nm japropos , .Nm jwhatis .Nd search the Japanese whatis database for strings .Sh SYNOPSIS .Nm japropos .Ar keyword ... .Nm jwhatis .Ar keyword ... .Sh DESCRIPTION .Nm searches a set of Japanese database files containing short descriptions of system commands for keywords and displays the result on the standard output. .Nm jwhatis displays only complete word matches. You have to set the environment variable LC_CTYPE (or LANG) to ja_JP.EUC if you prefer to consult Japanese manual pages. .Sh RETURN VALUES The .Nm utility exits 0 on success, and 1 if no keyword matched. .Sh SEE ALSO .Xr jmakewhatis 1 , .Xr jman 1 jp-man-1.1j/apropos/japropos.man100644 5777 310 2757 7311134070 15502 0ustar tkumanoslt.\" Man page for japropos .\" .\" Copyright (c) 1990, 1991, John W. Eaton. .\" .\" You may distribute under the terms of the GNU General Public .\" License as specified in the README file that comes with the man 1.0 .\" distribution. .\" .\" John W. Eaton .\" jwe@che.utexas.edu .\" Department of Chemical Engineering .\" The University of Texas at Austin .\" Austin, Texas 78712 .\" \" $FreeBSD: src/gnu/usr.bin/man/apropos/apropos.man,v 1.8 2000/12/11 15:10:52 ru Exp $ .\" .\" Japanized by .\" Copyright (c) KUMANO, Tadashi , 1996-2001, .\" Copyright (c) FreeBSD jp-man project , 1996, .\" which is a study toward the multilingual enhancement. .\" (version 1.1j 2001/06/11) .\" .Dd June 11, 2001 .Dd January 15, 2001 .Dt JAPROPOS 1 .Os .Sh 名称 .Nm japropos , .Nm jwhatis .Nd 日本語マニュアルページを含めた whatis データベースを文字列によって探索 .Sh 書式 .Nm japropos .Ar keyword ... .Nm jwhatis .Ar keyword ... .Sh 解説 .Nm japropos はシステムコマンドに関する短い記述を含んだ日本語マニュアルページおよびオリジナルの英文マニュアルページ用のデータベースファイルをキーワードによって探索して、結果を標準出力に表示します。 .Nm jwhatis は同様に、キーワードと完全に一致したもののみを表示します。 どちらのコマンドも、日本語マニュアルページを探索するためにはあらかじめ環境変数 LC_CTYPE か LANG を ja_JP.EUC に設定しておく必要があります。 .Sh 返値 .Nm japropos は成功時には 0 を、該当するキーワードがなかった時には 1 を返します。 .Sh 関連項目 .Xr jmakewhatis 1 , .Xr jman 1 jp-man-1.1j/catman/ 40755 5777 310 0 7311135557 12633 5ustar tkumanosltjp-man-1.1j/catman/Makefile100644 5777 310 3026 6442520152 14362 0ustar tkumanoslt.if exists(${.CURDIR}/obj) MAN1= ${.CURDIR}/obj/jcatman.1 EMAN1= ${.CURDIR}/obj/jcatman.1.eng.gz TARG= ${.CURDIR}/obj/jcatman .else MAN1= ${.CURDIR}/jcatman.1 EMAN1= ${.CURDIR}/jcatman.1.eng.gz TARG= ${.CURDIR}/jcatman .endif MANDEPEND= ${MAN1} CLEANFILES+= ${TARG} ${MAN1} ${EMAN1} all: ${TARG} ${MAN1} ${EMAN1} depend rcsfreeze tags all: @echo -n ${TARG}: ${.CURDIR}/catman.perl sed -e 's,#nroff#,${nroff},' \ -e 's,#zcat#,${zcat},' -e 's,#tbl#,${tbl},' \ -e 's,#compress#,${compress},' \ ${.CURDIR}/catman.perl > ${.TARGET} chmod 755 ${.TARGET} ${MAN1}: ${.CURDIR}/jcatman.man sed -e 's,%libdir%,${libdir},' -e 's,%bindir%,${bindir},' \ -e 's,%pager%,${pager},' -e 's,%troff%,${troff},' \ -e 's,%manpath_config_file%,${manpath_config_file},' \ ${.CURDIR}/jcatman.man > ${.TARGET} ${EMAN1}: ${.CURDIR}/jcatman.man.eng sed -e 's,%libdir%,${libdir},' -e 's,%bindir%,${bindir},' \ -e 's,%pager%,${pager},' -e 's,%troff%,${troff},' \ -e 's,%manpath_config_file%,${manpath_config_file},' \ ${.CURDIR}/jcatman.man.eng | \ ${compress} > ${.TARGET} install: ${TARG} maninstall after_maninstall ${INSTALL} -c -o bin -g bin -m 555 ${TARG} ${DESTDIR}${BINDIR} .if !defined(NOMAN) after_maninstall: ${EMAN1} ${INSTALL} -c -o bin -g bin -m 444 ${EMAN1} \ ${DESTDIR}${EMANDIR}1/jcatman.1.gz .else after_maninstall: .endif .include "../Makefile.inc" .if make(maninstall) || make(install) .if !defined(NOMAN) .include .elif !target(maninstall) maninstall: .endif .endif .include jp-man-1.1j/catman/catman.perl100644 5777 310 25760 6763751067 15123 0ustar tkumanoslt#!/usr/bin/perl # # Copyright (c) March 1995 Wolfram Schneider . Berlin. # All rights reserved. # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions # are met: # 1. Redistributions of source code must retain the above copyright # notice, this list of conditions and the following disclaimer. # 2. Redistributions in binary form must reproduce the above copyright # notice, this list of conditions and the following disclaimer in the # documentation and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND # ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE # FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL # DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS # OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) # HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT # LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY # OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF # SUCH DAMAGE. # # /usr/bin/catman - preformat man pages # # $Id: catman.perl,v 1.12 1998/08/05 03:44:46 thepish Exp $ # # Japanized by # Copyright (c) KUMANO, Tadashi , 1996-1999, # Copyright (c) FreeBSD jp-man project , 1996, 1998, # which is a study toward the multilingual enhancement. # (version 1.1h 1999/09/03) # sub usage { warn <= 0; return @defaultmanpath if $#defaultmanpath >= 0; warn "Missing directories\n"; &usage; } # make relative path to absolute path sub absolute_path { local(@dirlist) = @_; local($pwd, $dir, @a); $pwd = $ENV{'PWD'}; foreach $dir (@dirlist) { if ($dir !~ "^/") { chop($pwd = `pwd`) if (!$pwd || $pwd !~ /^\//); push(@a, "$pwd/$dir"); } else { push(@a, $dir); } } return @a; } # strip unused '/' # e.g.: //usr///home// -> /usr/home sub stripdir { local($dir) = @_; $dir =~ s|/+|/|g; # delete double '/' $dir =~ s|/$||; # delete '/' at end $dir =~ s|/(\.\/)+|/|g; # delete ././././ $dir =~ s|/+|/|g; # delete double '/' $dir =~ s|/$||; # delete '/' at end $dir =~ s|/\.$||; # delete /. at end return $dir if $dir ne ""; return '/'; } # read man directory sub parse_dir { local($dir) = @_; local($subdir, $catdir); local($dev,$ino) = (stat($dir))[01]; # already visit if ($dir_visit{$dev,$ino}) { warn "$dir already parsed: $dir_visit{$dev,$ino}\n"; return 1; } $dir_visit{$dev,$ino} = $dir; # Manpath, /usr/share/man/{ja_JP.EUC,ja_JP,ja} or /usr/share/man if ($dir =~ /man$/ || defined($locale) && ($dir =~ m|man/$locale$| || defined($locale1) && $dir =~ m|man/$locale1$| || defined($locale2) && $dir =~ m|man/$locale2$|)) { warn "open manpath directory ``$dir''\n" if $verbose; if (!opendir(DIR, $dir)) { warn "opendir ``$dir'':$!\n"; $exit = 1; return 0; } warn "chdir to: $dir\n" if $verbose; chdir($dir) || do { warn "$dir: $!\n"; $exit = 1; return 0 }; foreach $subdir (sort(readdir(DIR))) { if ($subdir =~ /^man\w+$/) { $subdir = "$dir/$subdir"; &catdir_create($subdir) && &parse_subdir($subdir); } } closedir DIR # subdir, /usr/share/man/{ja_JP.EUC,ja_JP,ja}/man1 or /usr/share/man/man1 } elsif ($dir =~ /man\w+$/) { local($parentdir) = $dir; $parentdir =~ s|/[^/]+$||; warn "chdir to: $parentdir\n" if $verbose; chdir($parentdir) || do { warn "$parentdir: $!\n"; $exit = 1; return 0 }; &catdir_create($dir) && &parse_subdir($dir); } else { warn "Assume ``$dir'' is not a man directory.\n"; $exit = 1; } } # create cat subdirectory if neccessary # e.g.: man9 exist, but cat9 not sub catdir_create { local($subdir) = @_; local($catdir) = $subdir; $catdir = &man2cat($subdir); if (-d $catdir) { return 1 if -w _; if (!chmod(0755, $catdir)) { warn "Cannot write $catdir, chmod: $!\n"; $exit = 1; return 0; } return 1; } warn "mkdir ``$catdir''\n" if $verbose || $print; unless ($print) { unlink($catdir); # be paranoid if (!mkdir($catdir, 0755)) { warn "Cannot make $catdir: $!\n"; $exit = 1; return 0; } return 1; } } # I: /usr/share/man/man9 # O: /usr/share/man/cat9 sub man2cat { local($man) = @_; $man =~ s/man(\w+)$/cat$1/; return $man; } sub parse_subdir { local($subdir) = @_; local($file, $f, $catdir, $catdir_short, $mandir, $mandir_short); local($mtime_man, $mtime_cat); local(%read); $mandir = $subdir; $catdir = &man2cat($mandir); ($mandir_short = $mandir) =~ s|.*/(.*)|$1|; ($catdir_short = $catdir) =~ s|.*/(.*)|$1|; warn "open man directory: ``$mandir''\n" if $verbose; if (!opendir(D, $mandir)) { warn "opendir ``$mandir'': $!\n"; $exit = 1; return 0; } foreach $file (readdir(D)) { # skip current and parent directory next if $file eq "." || $file eq ".."; # fo_09-o.bar0 if ($file !~ /^[\w\-\+\[\.:]+\.\w+$/) { &garbage("$mandir/$file", "Assume garbage") unless -d "$mandir/$file"; next; } if ($file !~ /\.gz$/) { if (-e "$mandir/$file.gz") { &garbage("$mandir/$file", "Manpage unused, see compressed version"); next; } warn "$mandir/$file is uncompressed\n" if $verbose; $cfile = "$file.gz"; } else { $cfile = "$file"; } if (!(($mtime_man = ((stat("$mandir_short/$file"))[9])) && -r _ && -f _)) { if (! -d _) { warn "Cannot read file: ``$mandir/$file''\n"; $exit = 1; if ($remove && -l "$mandir/$file") { &garbage("$mandir/$file", "Assume wrong symlink"); } next; } warn "Ignore subsubdirectory: ``$mandir/$file''\n" if $verbose; next; } $read{$file} = 1; # Assume catpages always compressed if (($mtime_cat = ((stat("$catdir_short/$cfile"))[9])) && -r _ && -f _) { if ($mtime_man > $mtime_cat || $force) { &nroff("$mandir/$file", "$catdir/$cfile"); } else { warn "up to date: $mandir/$file\n" if $verbose; #print STDERR "." if $verbose; } } else { &nroff("$mandir/$file", "$catdir/$cfile"); } } closedir D; if (!opendir(D, $catdir)) { warn "opendir ``$catdir'': $!\n"; return 0; } warn "open cat directory: ``$catdir''\n" if $verbose; foreach $file (readdir(D)) { next if $file =~ /^(\.|\.\.)$/; # skip current and parent directory if ($file !~ /^[\w\-\+\[\.:]+\.\w+$/) { &garbage("$catdir/$file", "Assume garbage") unless -d "$catdir/$file"; next; } if ($file !~ /\.gz$/ && $read{"$file.gz"}) { &garbage("$catdir/$file", "Catpage unused, see compressed version"); } elsif (!$read{$file}) { # maybe a bug in man(1) # if both manpage and catpage are uncompressed, man reformats # the manpage and puts a compressed catpage to the # already existing uncompressed catpage ($f = $file) =~ s/\.gz$//; # man page is uncompressed, catpage is compressed next if $read{$f}; &garbage("$catdir/$file", "Catpage without manpage"); } } closedir D; } sub garbage { local($file, @text) = @_; warn "@text: ``$file''\n"; if ($remove) { warn "unlink $file\n"; unless ($print) { unlink($file) || warn "unlink $file: $!\n" ; } } } sub nroff { local($man,$cat) = @_; local($nroff) = "#nroff#"; local($dev, $ino) = (stat($man))[01]; # It's a link if ($link{"$dev.$ino"}) { warn "Link: $link{\"$dev.$ino\"} -> $cat\n" if $verbose || $print; return if $print; # done unlink($cat); # remove possible old link unless (link($link{"$dev.$ino"}, $cat)) { warn "Link $cat: $!\n"; $exit = 1; } return; } else { $cat = "$cat$ext" if $cat !~ /$ext$/; warn "Format: $man -> $cat\n" if $verbose || $print; unless($print) { # man page is compressed if ($man =~ /$ext$/) { $nroff = "#zcat# $man | #tbl# | $nroff"; } else { $nroff = "#tbl# $man | $nroff"; } # start formatting $tmp = "$cat.$tmp"; # for cleanup after signals system("$nroff | #compress# > $cat.tmp"); if ($?) { # assume a fatal signal to nroff &Exit("INT to system() function") if ($? == 2); } else { rename("$cat.tmp", $cat); } } } # dev/ino from manpage, path from catpage $link{"$dev.$ino"} = $cat; } ############# # main warn "Don't start this program as root, use:\n" . "echo $0 @ARGV | nice -5 su -m man\n" unless $>; # set locale if (defined($ENV{'LC_ALL'})) { $locale = $ENV{'LC_ALL'}; } elsif (defined($ENV{'LC_CTYPE'})) { $locale = $ENV{'LC_CTYPE'}; } elsif (defined($ENV{'LANG'})) { $locale = $ENV{'LANG'}; } else { undef $locale; } if (defined($locale)) { if ($locale =~ /^.._..\../) { $locale1 = substr($locale, 0, 5); } else { undef $locale1; } if ($locale =~ /^.._../) { $locale2 = substr($locale, 0, 2); } else { undef $locale2; } } &variables; foreach $dir (&parse(split(/[ :]/, join($", @ARGV)))) { #" if (-e $dir && -d _ && -r _ && -x _) { warn "``$dir'' is not writable for you,\n" . "can only write to existing cat subdirs (if any)\n" if ! -w _ && $verbose; &parse_dir(&stripdir($dir)); } else { warn "``$dir'' is not a directory or not read-/searchable for you\n"; $exit = 1; } } exit($exit); jp-man-1.1j/catman/jcatman.man100644 5777 310 12635 7311123106 15054 0ustar tkumanoslt.\" Copyright (c) March 1996 Wolfram Schneider . Berlin. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" /usr/bin/catman - preformat man pages .\" .\" $FreeBSD: src/gnu/usr.bin/man/catman/catman.1,v 1.22 2001/02/01 16:26:41 ru Exp $ .\" .\" Japanized by .\" Copyright (c) KUMANO, Tadashi , 1996-2001, .\" Copyright (c) FreeBSD jp-man project , 1996, 1998, .\" which is a study toward the multilingual enhancement. .\" (version 1.1j 2001/06/11) .\" .Dd June 11, 2001 .Dt JCATMAN 1 .Os .Sh 名称 .Nm jcatman .Nd 日本語マニュアルページを含めたマニュアルページをあらかじめフォーマットしておく .Sh 書式 .Nm jcatman .Op Fl f | Fl force .Op Fl h | Fl help .Op Fl p | Fl print .Op Fl r | Fl remove .Op Fl v | Fl verbose .Op Ar directories ... .Sh 解説 .Nm jcatman は日本語および英文オリジナルのマニュアルページを ASCII/EUC テキストにフォーマットします。 これは .Ar directories にある全ての日本語およびオリジナルのマニュアルページに対して .Sq man program とタイプするのと似ています。 .Ar directories は日本語およびオリジナルのマニュアルディレクトリ/サブディレクトリのリストであり、 空白もしくはコロンで区切ります。 .Ar directories に日本語マニュアルのディレクトリを含めるときには、環境変数 LC_CTYPE か LANG を ja_JP.EUC に設定しておく必要があります。 .Ar directories が指定されない場合には .Ar /usr/share/man/ja_JP.EUC , .Ar /usr/share/man/ja_JP , .Ar /usr/share/man/ja のうち存在するディレクトリ(LC_CTYPE か LANG を ja_JP.EUC に設定した場合)、もしくは .Ar /usr/share/man (それ以外) を対象とします。 .Sh オプション .Bl -tag -width Ds .It Fl f , Fl force 強制的に古いフォーマット済ページを上書きします。 このオプションを指定しない場合は、最新ではないページのみをフォーマットします。 このオプションを使用すると大量の時間、CPU、メモリを消費します。 .It Fl h , Fl help 使用可能なオプションを表示し、終了します。 .It Fl p , Fl print 実際にはマニュアルページのフォーマットを行いません。 どのような動作を行うのかを表示します。 .It Fl r , Fl remove ゴミを消去します。すなわち、マニュアルページが無いフォーマット済ページ、 圧縮されたフォーマット済ページがある圧縮されていないフォーマット済ページ、 非英数字から成る名前のファイル、 圧縮されたマニュアルページがある圧縮されていないマニュアルページを消去します。 .It Fl v , Fl verbose 警告を多く表示します。 .El .Sh 使用例 .Pp .Dl $ jcatman .Pp .Ar /usr/share/man/ja_JP.EUC , .Ar /usr/share/man/ja_JP , .Ar /usr/share/man/ja のうち存在するディレクトリの中のフォーマットの必要なマニュアルページをフォーマットします。 .Pp .Dl $ jcatman $MANPATH .Pp ユーザのマニュアルページでフォーマットの必要なものを 全てフォーマットします。 .Pp .Dl $ jcatman -f /usr/share/man/ja/man1 /usr/share/man/ja/manl .Pp 強制的に .Pa /usr/share/man/ja/man1 および .Pa /usr/share/man/ja/manl にあるマニュアルページを再フォーマットします。 .Pp .Dl $ jcatman -p /usr/X11R6/man/ja .Pp どのような動作を行うかだけを表示します。 .\" .Sh 関連ファイル .\" .Bl -tag -width /etc/periodic/weekly/330.catman .\" .It Pa /etc/periodic/weekly/330.catman .\" このプログラムを実行します。 .\" .El .Sh 特徴 全ての日本語マニュアルページがフォーマット済の場合は非常に高速です。 他のシステムでサポートしている .Fl w オプションはサポートしません。 .Xr jmakewhatis 1 を使用して、 .Ql whatis データベースを再構築して下さい。 .Sh バグ .Xr jman 1 は setuid プログラムです。 ユーザ .Sq man が日本語のフォーマット済マニュアルを格納する ディレクトリに書き込み権限を持つようにして下さい。 .Nm jcatman は日本語マニュアルページソース中の .Sq .so をチェックしません。ハードリンクもしくはシンボリックリンクを使用し、 冗長に日本語マニュアルページがフォーマットされないようにして下さい。 .Sh 環境変数 .Bl -tag -width LC_CTYPE .It Sy LC_CTYPE .It Sy LANG オリジナルのマニュアルページの他に扱うことのできるマニュアルページの言語を 決定します。 日本語マニュアルページを扱うためには .Sy LC_CTYPE または .Sy LANG が ja_JP.EUC にセットされている必要があります。 .Sh 関連項目 .Xr jman 1 , .Xr jmanpath 1 , .Xr jmakewhatis 1 . .Sh 歴史 このバージョンのオリジナルの .Nm catman コマンドは FreeBSD 2.1 から登場しました。 日本語版の .Nm jcatman コマンドは FreeBSD 2.2 から ports/packages として登場しました。 .Sh 作者 .An Wolfram Schneider Aq wosch@FreeBSD.org , Berlin. .Sh 日本語対応 熊野 正 .Aq kumano@jp.freebsd.org jp-man-1.1j/catman/jcatman.man.eng100644 5777 310 11130 7311123111 15605 0ustar tkumanoslt.\" Copyright (c) March 1996 Wolfram Schneider . Berlin. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" /usr/bin/catman - preformat man pages .\" .\" $FreeBSD: src/gnu/usr.bin/man/catman/catman.1,v 1.22 2001/02/01 16:26:41 ru Exp $ .\" .\" Japanized by .\" Copyright (c) KUMANO, Tadashi , 1996-2001, .\" Copyright (c) FreeBSD jp-man project , 1996, 1998, .\" which is a study toward the multilingual enhancement. .\" (version 1.1j 2001/06/11) .\" .Dd June 11, 2001 .Dt JCATMAN 1 .Os .Sh NAME .Nm jcatman .Nd preformat Japanese or original (English) man pages .Sh SYNOPSIS .Nm .Op Fl f | Fl force .Op Fl h | Fl help .Op Fl p | Fl print .Op Fl r | Fl remove .Op Fl v | Fl verbose .Op Ar directories ... .Sh DESCRIPTION .Nm Jcatman format Japanese or original (English) man pages to ASCII/EUC. It's like typing .Sq man program for all Japanese or original man pages in .Ar directories . .Ar Directories is a list of Japanese or original man directories or subdirectories separated by spaces or colons. You have to set the envionment variable LC_CTYPE (or LANG) to ja_JP.EUC if you include Japanese man directories in .Ar directories . Use existing directories of .Ar /usr/share/man/ja_JP.EUC , .Ar /usr/share/man/ja_JP , .Ar /usr/share/man/ja (if LC_CTYPE or LANG set to ja_JP.EUC) or .Ar /usr/share/man (other) if no .Ar directories defined. .Sh OPTIONS .Bl -tag -width Ds .It Fl f , Fl force Force overwriting old cat pages. Normally only those pages will be formatted which are not up to date. This option is a waste of time, CPU and RAM. .It Fl h , Fl help Print options and exit. .It Fl p , Fl print Don't actually format man pages. Show what would be done. .It Fl r , Fl remove Remove garbage, e.\& g. catpage without manpage, uncompressed catpage but a compressed catpage exist, filenames with non-alphanumeric characters, uncompressed manpage but a compressed manpage exist. .It Fl v , Fl verbose More warnings. .El .Sh EXAMPLES .Pp .Dl $ jcatman .Pp Format man pages in existing directories of .Ar /usr/share/man/ja_JP.EUC , .Ar /usr/share/man/ja_JP , .Ar /usr/share/man/ja if necessary. .Pp .Dl $ jcatman $MANPATH .Pp Format all your man pages if necessary. .Pp .Dl $ jcatman -f /usr/share/man/ja/man1 /usr/share/man/ja/manl .Pp Force reformatting of all man pages in .Pa /usr/share/man/ja/man1 and .Pa /usr/share/man/ja/manl . .Pp .Dl $ jcatman -p /usr/X11R6/man/ja .Pp Show only. .\" .Sh FILES .\" .Bl -tag -width /etc/periodic/weekly/330.catman .\" .It Pa /etc/periodic/weekly/330.catman .\" start this program .\" .El .Sh FEATURES Very fast if all man Japanese pages already formatted. Does not support the .Fl w option as some other systems do. Use .Xr jmakewhatis 1 to rebuild the .Ql whatis database. .Sh BUGS .Xr jman 1 is a setuid program. Be careful that user .Sq man has write permissions to the jcatman directories. .Nm Jcatman does not check for any .Sq .so in Japanese man page sources. Use hard or symlinks to avoid redundant formatted Japanese man pages. .Sh SEE ALSO .Xr jman 1 , .Xr jmanpath 1 , .Xr jmakewhatis 1 . .Sh HISTORY The original version of .Nm catman command appeared in FreeBSD 2.1. Japanized .Nm jcatman command appeared in ports/packages collection of FreeBSD 2.2. .Sh AUTHORS .An Wolfram Schneider Aq wosch@FreeBSD.org , Berlin. .Sh JAPANIZATION KUMANO, Tadashi .Aq kumano@jp.freebsd.org jp-man-1.1j/lib/ 40755 5777 310 0 6764305670 12144 5ustar tkumanosltjp-man-1.1j/lib/Makefile100644 5777 310 1562 6763751210 13677 0ustar tkumanosltLIB= man INTERNALLIB= true INTERNALSTATICLIB= true CFLAGS+= -DSTDC_HEADERS CLEANFILES+= config.h SRCS= gripes.c util.c # Kludge to create config.h for other modules. The library itself doesn't # depend on config.h. SRCS+= config.h config.h: ${.CURDIR}/config.h_dist ${.CURDIR}/../Makefile.inc sed -e 's,%apropos%,${apropos},' -e 's,%whatis%,${whatis},' \ -e 's,%pager%,${pager},' -e 's,%troff%,${troff},' \ -e 's,%nroff%,${nroff},' -e 's,%tbl%,${tbl},' \ -e 's,%col%,${col},' -e 's,%pic%,${pic},' \ -e 's,%eqn%,${eqn},' -e 's,%neqn%,${neqn},' \ -e 's,%vgrind%,${vgrind},' -e 's,%refer%,${refer},' \ -e 's,%grap%,${grap},' -e 's,%zcat%,${zcat},' \ -e 's,%manpath_config_file%,${manpath_config_file},' \ -e 's,%compress%,${compress},' \ -e 's,%compext%,${compext},' \ ${.CURDIR}/config.h_dist > ${.TARGET} .include jp-man-1.1j/lib/config.h_dist100644 5777 310 12344 6763751437 14733 0ustar tkumanoslt/* * config.h * * If you haven't read the README file, now might be a good time. * * This file is edited by configure, so you shouldn't have to. * If that doesn't work, edit this file to match your site. * * Sorry it's so long, but there are lots of things you might want to * customize for your site. * * Copyright (c) 1990, 1991, John W. Eaton. * * You may distribute under the terms of the GNU General Public * License as specified in the file COPYING that comes with the man * distribution. * * John W. Eaton * jwe@che.utexas.edu * Department of Chemical Engineering * The University of Texas at Austin * Austin, Texas 78712 */ /* * This is the size of a number of internal buffers. It should * probably not be less than 512. */ #ifndef BUFSIZ #define BUFSIZ 1024 #endif /* * This should be at least the size of the longest path. */ #ifndef MAXPATHLEN #define MAXPATHLEN 1024 #endif /* * This is the maximum number of directories expected in the manpath. */ #ifndef MAXDIRS #define MAXDIRS 64 #endif /* * This is the name of the group that owns the preformatted man pages. * If you are running man as a setgid program, you should make sure * that all of the preformatted man pages and the directories that * they live in are readable and writeable and owned by this group. */ #ifdef SECURE_MAN_UID #define MAN_USER "" #endif /* * It's probably best to define absolute paths to all of these. If * you don't, you'll be depending on the user's path to be correct * when system () is called. This can result in weird behavior that's * hard to track down, especially after you forget how this program * works... If you don't have some of these programs, simply define * them to be empty strings (i.e. ""). As a minimum, you must have * nroff installed. */ #ifndef APROPOS #define APROPOS "%apropos%" #endif #ifndef WHATIS #define WHATIS "%whatis%" #endif #ifndef PAGER #define PAGER "%pager%" #endif #ifdef HAS_TROFF #ifndef TROFF #define TROFF "%troff%" #endif #endif #ifndef NROFF #define NROFF "%nroff%" #endif #ifndef EQN #define EQN "%eqn%" #endif #ifndef NEQN #define NEQN "%neqn%" #endif #ifndef TBL #define TBL "%tbl%" #endif #ifndef COL #define COL "%col%" #endif #ifndef VGRIND #define VGRIND "%vgrind%" #endif #ifndef REFER #define REFER "%refer%" #endif #ifndef GRAP #define GRAP "%grap%" #endif #ifndef PIC #define PIC "%pic%" #endif /* * Define the absolute path to the configuration file. */ #ifndef MAN_MAIN static char config_file[] = "%manpath_config_file%" ; #endif /* * Define the uncompression program(s) to use for those preformatted * pages that end in the given character. If you add extras here, you * may need to change man.c. [I have no idea what FCAT and YCAT files * are! - I will leave them in for now.. -jkh] */ /* .F files */ #define FCAT "" /* .Y files */ #define YCAT "" /* .Z files */ #define ZCAT "%zcat%" /* * This is the standard program to use on this system for compressing * pages once they have been formatted, and the character to tack on * to the end of those files. The program listed is expected to read * from the standard input and write compressed output to the standard * output. These won't actually be used unless compression is enabled. */ #ifdef DO_COMPRESS #define COMPRESSOR "%compress%" #define COMPRESS_EXT "%compext%" #endif /* * Define the standard manual sections. For example, if your man * directory tree has subdirectories man1, man2, man3, mann, * and man3foo, std_sections[] would have "1", "2", "3", "n", and * "3foo". Directories are searched in the order they appear. Having * extras isn't fatal, it just slows things down a bit. * * Note that this is just for directories to search. If you have * files like .../man3/foobar.3Xtc, you don't need to have "3Xtc" in * the list below -- this is handled separately, so that `man 3Xtc foobar', * `man 3 foobar', and `man foobar' should find the file .../man3/foo.3Xtc, * (assuming, of course, that there isn't a .../man1/foo.1 or somesuch * that we would find first). * * Note that this list should be in the order that you want the * directories to be searched. Is there a standard for this? What is * the normal order? If anyone knows, please tell me! */ #ifndef MANPATH_MAIN static char *std_sections[] = { "1", "1aout", "8", "2", "3", "n", "4", "5", "6", "7", "9", "l", NULL }; #endif /* * Not all systems define these in stat.h. */ #ifndef S_IRUSR #define S_IRUSR 00400 /* read permission: owner */ #endif #ifndef S_IWUSR #define S_IWUSR 00200 /* write permission: owner */ #endif #ifndef S_IRGRP #define S_IRGRP 00040 /* read permission: group */ #endif #ifndef S_IWGRP #define S_IWGRP 00020 /* write permission: group */ #endif #ifndef S_IROTH #define S_IROTH 00004 /* read permission: other */ #endif #ifndef S_IWOTH #define S_IWOTH 00002 /* write permission: other */ #endif /* * This is the mode used for formatted pages that we create. If you * are using the setgid option, you should use 664. If you are not, * you should use 666 and make the cat* directories mode 777. */ #ifndef CATMODE #ifdef SECURE_MAN_UID #define CATMODE S_IRUSR | S_IWUSR | S_IRGRP | S_IWGRP | S_IROTH #else #define CATMODE S_IRUSR | S_IWUSR | S_IRGRP | S_IWGRP | S_IROTH | S_IWOTH #endif #endif jp-man-1.1j/lib/gripes.c100644 5777 310 5755 6437733723 13713 0ustar tkumanoslt/* * gripes.c * * Copyright (c) 1990, 1991, John W. Eaton. * * You may distribute under the terms of the GNU General Public * License as specified in the file COPYING that comes with the man * distribution. * * John W. Eaton * jwe@che.utexas.edu * Department of Chemical Engineering * The University of Texas at Austin * Austin, Texas 78712 */ #include #include "gripes.h" #ifdef STDC_HEADERS #include #else extern int fprintf (); extern int fflush (); extern int exit (); #endif extern char *prognam; void gripe_no_name (section) char *section; { if (section) fprintf (stderr, "What manual page do you want from section %s?\n", section); else fprintf (stderr, "What manual page do you want?\n"); fflush (stderr); } void gripe_reading_man_file (name) char *name; { fprintf (stderr, "Read access denied for file %s\n", name); fflush (stderr); } void gripe_converting_name (name, to_cat) char *name; int to_cat; { if (to_cat) fprintf (stderr, "Error converting %s to cat name\n", name); else fprintf (stderr, "Error converting %s to man name\n", name); fflush (stderr); exit (1); } void gripe_system_command (status) int status; { fprintf (stderr, "Error executing formatting or display command.\n"); fprintf (stderr, "system command exited with status %d\n", status); fflush (stderr); } void gripe_not_found (name, section) char *name, *section; { if (section) fprintf (stderr, "No entry for %s in section %s of the manual\n", name, section); else fprintf (stderr, "No manual entry for %s\n", name); fflush (stderr); } void gripe_incompatible (s) char *s; { fprintf (stderr, "%s: incompatible options %s\n", prognam, s); fflush (stderr); exit (1); } void gripe_getting_mp_config (file) char *file; { fprintf (stderr, "%s: unable to find the file %s\n", prognam, file); fflush (stderr); exit (1); } void gripe_reading_mp_config (file) char *file; { fprintf (stderr, "%s: unable to make sense of the file %s\n", prognam, file); fflush (stderr); exit (1); } void gripe_invalid_section (section) char *section; { fprintf (stderr, "%s: invalid section (%s) selected\n", prognam, section); fflush (stderr); exit (1); } void gripe_manpath () { fprintf (stderr, "%s: manpath is null\n", prognam); fflush (stderr); exit (1); } void gripe_alloc (bytes, object) int bytes; char *object; { fprintf (stderr, "%s: can't malloc %d bytes for %s\n", prognam, bytes, object); fflush (stderr); exit (1); } void gripe_roff_command_from_file (file) char *file; { fprintf (stderr, "Error parsing *roff command from file %s\n", file); fflush (stderr); } void gripe_roff_command_from_env () { fprintf (stderr, "Error parsing MANROFFSEQ. Using system defaults.\n"); fflush (stderr); } void gripe_roff_command_from_command_line () { fprintf (stderr, "Error parsing *roff command from command line.\n"); fflush (stderr); } jp-man-1.1j/lib/gripes.h100644 5777 310 1571 6437733734 13712 0ustar tkumanoslt/* * gripes.h * * Copyright (c) 1990, 1991, John W. Eaton. * * You may distribute under the terms of the GNU General Public * License as specified in the file COPYING that comes with the man * distribution. * * John W. Eaton * jwe@che.utexas.edu * Department of Chemical Engineering * The University of Texas at Austin * Austin, Texas 78712 */ extern void gripe_no_name (); extern void gripe_converting_name (); extern void gripe_system_command (); extern void gripe_reading_man_file (); extern void gripe_not_found (); extern void gripe_invalid_section (); extern void gripe_manpath (); extern void gripe_alloc (); extern void gripe_incompatible (); extern void gripe_getting_mp_config (); extern void gripe_reading_mp_config (); extern void gripe_roff_command_from_file (); extern void gripe_roff_command_from_env (); extern void gripe_roff_command_from_command_line (); jp-man-1.1j/lib/util.c100644 5777 310 5470 6763751567 13401 0ustar tkumanoslt/* * util.c * * Copyright (c) 1990, 1991, John W. Eaton. * * You may distribute under the terms of the GNU General Public * License as specified in the file COPYING that comes with the man * distribution. * * John W. Eaton * jwe@che.utexas.edu * Department of Chemical Engineering * The University of Texas at Austin * Austin, Texas 78712 */ #include #include #include #include #include #include #ifdef STDC_HEADERS #include #else extern int fprintf (); extern int tolower (); #endif extern char *strdup (); extern int system (); #include "gripes.h" /* * Extract last element of a name like /foo/bar/baz. */ char * mkprogname (s) register char *s; { char *t; t = strrchr (s, '/'); if (t == (char *)NULL) t = s; else t++; return strdup (t); } void downcase (s) unsigned char *s; { register unsigned char c; while ((c = *s) != '\0') { if (isalpha (c)) *s = tolower (c); s++; } } /* * Is file a newer than file b? * * case: * * a newer than b returns 1 * a older than b returns 0 * stat on a fails returns -1 * stat on b fails returns -2 * stat on a and b fails returns -3 */ int is_newer (fa, fb) register char *fa; register char *fb; { struct stat fa_sb; struct stat fb_sb; register int fa_stat; register int fb_stat; register int status = 0; fa_stat = stat (fa, &fa_sb); if (fa_stat != 0) status = 1; fb_stat = stat (fb, &fb_sb); if (fb_stat != 0) status |= 2; if (status != 0) return -status; return (fa_sb.st_mtime > fb_sb.st_mtime); } /* * Is path a directory? */ int is_directory (path) char *path; { struct stat sb; register int status; status = stat (path, &sb); if (status != 0) return -1; return ((sb.st_mode & S_IFDIR) == S_IFDIR); } /* * Attempt a system () call. Return 1 for success and 0 for failure * (handy for counting successes :-). */ int do_system_command (command) char *command; { int status = 0; extern int debug; /* * If we're debugging, don't really execute the command -- you never * know what might be in that mangled string :-O. */ if (debug) fprintf (stderr, "\ntrying command: %s\n", command); else status = system (command); /* check return value from system() function first */ if (status == -1) { fprintf(stderr, "wait() for exit status of shell failed in function system()\n"); return 0; } else if (status == 127 || status == (127 << 8)) { fprintf(stderr, "execution of the shell failed in function system()\n"); return 0; } if (WIFSIGNALED(status)) return -1; else if (WEXITSTATUS(status)) { gripe_system_command (status); return 0; } else return 1; } jp-man-1.1j/makewhatis/ 40755 5777 310 0 7311135557 13525 5ustar tkumanosltjp-man-1.1j/makewhatis/Makefile100644 5777 310 6267 6763751753 15311 0ustar tkumanoslt# $Id: Makefile,v 1.15 1999/02/09 17:23:01 wosch Exp $ # # Japanized by # Copyright (c) KUMANO, Tadashi , 1996-1999, # Copyright (c) FreeBSD jp-man project , 1996, 1998, # which is a study toward the multilingual enhancement. # (version 1.1h 1999/09/03) MAINTAINER= wosch .if exists(${.CURDIR}/obj) MAN1= ${.CURDIR}/obj/jmakewhatis.1 EMAN1= ${.CURDIR}/obj/jmakewhatis.1.eng.gz MAN8= ${.CURDIR}/obj/jmakewhatis.local.8 EMAN8= ${.CURDIR}/obj/jmakewhatis.local.8.eng.gz TARG= ${.CURDIR}/obj/jmakewhatis TARG2= ${.CURDIR}/obj/jmakewhatis.local .else MAN1= ${.CURDIR}/jmakewhatis.1 EMAN1= ${.CURDIR}/jmakewhatis.1.eng.gz MAN8= ${.CURDIR}/jmakewhatis.local.8 EMAN8= ${.CURDIR}/jmakewhatis.local.8.eng.gz TARG= ${.CURDIR}/jmakewhatis TARG2= ${.CURDIR}/jmakewhatis.local .endif MLINKS= jmakewhatis.local.8 jcatman.local.8 MANDEPEND= ${MAN1} ${MAN8} CLEANFILES+= ${TARG} ${TARG2} ${MAN1} ${EMAN1} ${MAN8} ${EMAN8} all: ${TARG} ${TARG2} ${MAN1} ${EMAN1} ${MAN8} ${EMAN8} depend rcsfreeze tags all: @echo -n ${TARG}: ${.CURDIR}/makewhatis.perl sed -e 's,#zcat#,${zcat},' \ ${.CURDIR}/makewhatis.perl > ${.TARGET} chmod 755 ${.TARGET} ${TARG2}: ${.CURDIR}/makewhatis.local.sh cp ${.CURDIR}/makewhatis.local.sh ${.TARGET} chmod 755 ${.TARGET} ${MAN1}: ${.CURDIR}/jmakewhatis.man sed -e 's,%libdir%,${libdir},' -e 's,%bindir%,${bindir},' \ -e 's,%pager%,${pager},' -e 's,%troff%,${troff},' \ -e 's,%manpath_config_file%,${manpath_config_file},' \ ${.CURDIR}/jmakewhatis.man > ${.TARGET} ${EMAN1}: ${.CURDIR}/jmakewhatis.man.eng sed -e 's,%libdir%,${libdir},' -e 's,%bindir%,${bindir},' \ -e 's,%pager%,${pager},' -e 's,%troff%,${troff},' \ -e 's,%manpath_config_file%,${manpath_config_file},' \ ${.CURDIR}/jmakewhatis.man.eng | \ ${compress} > ${.TARGET} ${MAN8}: ${.CURDIR}/jmakewhatis.local.man sed -e 's,%libdir%,${libdir},' -e 's,%bindir%,${bindir},' \ -e 's,%pager%,${pager},' -e 's,%troff%,${troff},' \ -e 's,%manpath_config_file%,${manpath_config_file},' \ ${.CURDIR}/jmakewhatis.local.man > ${.TARGET} ${EMAN8}: ${.CURDIR}/jmakewhatis.local.man.eng sed -e 's,%libdir%,${libdir},' -e 's,%bindir%,${bindir},' \ -e 's,%pager%,${pager},' -e 's,%troff%,${troff},' \ -e 's,%manpath_config_file%,${manpath_config_file},' \ ${.CURDIR}/jmakewhatis.local.man.eng | \ ${compress} > ${.TARGET} install: ${TARG} ${TARG2} maninstall after_maninstall ${INSTALL} -c -o bin -g bin -m 555 ${TARG} ${DESTDIR}${BINDIR} ${INSTALL} -c -o bin -g bin -m 555 ${TARG2} ${DESTDIR}${libexecdir} ln -f ${DESTDIR}${libexecdir}/jmakewhatis.local \ ${DESTDIR}${libexecdir}/jcatman.local .if !defined(NOMAN) after_maninstall: ${EMAN1} ${EMAN8} ${INSTALL} -c -o bin -g bin -m 444 ${EMAN1} \ ${DESTDIR}${EMANDIR}1/jmakewhatis.1.gz ${INSTALL} -c -o bin -g bin -m 444 ${EMAN8} \ ${DESTDIR}${EMANDIR}8/jmakewhatis.local.8.gz ln -f ${DESTDIR}${EMANDIR}8/jmakewhatis.local.8.gz \ ${DESTDIR}${EMANDIR}8/jcatman.local.8.gz .else after_maninstall: .endif .include "../Makefile.inc" .if make(maninstall) || make(install) .if !defined(NOMAN) .include .elif !target(maninstall) maninstall: .endif .endif .include jp-man-1.1j/makewhatis/makewhatis.local.sh100644 5777 310 4666 6763755351 17432 0ustar tkumanoslt#!/bin/sh # # Copyright (c) April 1996 Wolfram Schneider . Berlin. # All rights reserved. # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions # are met: # 1. Redistributions of source code must retain the above copyright # notice, this list of conditions and the following disclaimer. # 2. Redistributions in binary form must reproduce the above copyright # notice, this list of conditions and the following disclaimer in the # documentation and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND # ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE # FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL # DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS # OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) # HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT # LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY # OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF # SUCH DAMAGE. # # makewhatis.local - start makewhatis(1) only for file systems # physically mounted on the system # # Running makewhatis from /etc/periodic/weekly/320.whatis for rw nfs-mounted # /usr may kill your NFS server -- all clients start makewhatis at the same # time! So use this wrapper instead calling makewhatis directly. # # PS: this wrapper works also for catman(1) # # $Id: makewhatis.local.sh,v 1.6 1999/07/30 21:12:35 nik Exp $ # # Japanized by # Copyright (c) KUMANO, Tadashi , 1996, 1997, 1999, # which is a study toward the multilingual enhancement. # (version 1.1h 1999/09/03) # PATH=/usr/local/bin:/bin:/usr/bin:$PATH; export PATH opt= dirs= localdirs= for arg do case "$arg" in -*) opt="$opt $arg";; *) dirs="$dirs $arg";; esac done dirs=`echo $dirs | sed 's/:/ /g'` case X"$dirs" in X) echo "usage: $0 [options] directories ..."; exit 1;; esac localdirs=`find -H $dirs -fstype local -type d -prune -print` case X"$localdirs" in X) echo "$0: no local-mounted manual directories found: $dirs" exit 1;; *) exec `basename $0 .local` $opt $localdirs;; esac jp-man-1.1j/makewhatis/makewhatis.perl100644 5777 310 32665 7311124153 16665 0ustar tkumanoslt#!/usr/bin/perl # # Copyright (c) 1994-1996 Wolfram Schneider . Berlin. # All rights reserved. # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions # are met: # 1. Redistributions of source code must retain the above copyright # notice, this list of conditions and the following disclaimer. # 2. Redistributions in binary form must reproduce the above copyright # notice, this list of conditions and the following disclaimer in the # documentation and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND # ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE # FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL # DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS # OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) # HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT # LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY # OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF # SUCH DAMAGE. # # makewhatis -- update the whatis database in the man directories. # # $FreeBSD: /home/ncvs/src/gnu/usr.bin/man/makewhatis/makewhatis.perl,v 1.20 1999/09/06 05:38:47 phantom Exp $ # # Japanized by # Copyright (c) KUMANO, Tadashi , 1996-2001, # Copyright (c) FreeBSD jp-man project , 1996, 1998, # which is a study toward the multilingual enhancement. # (version 1.1i 2001/01/15) # sub usage { warn <) { push(@a, $_); } close A; } else { warn "$whatisdb: $!\n" if lstat($file) && $verbose; # } undef $file; } warn "Open $whatisdb\n" if $verbose; if (!open(A, "> $whatisdb")) { die "$whatisdb: $!\n" if $outfile; warn "$whatisdb: $!\n"; $err++; return 0; } select A; return 1; } sub close_output { local($success) = @_; local($w) = $whatisdb; local($counter) = 0; local($i, $last,@b); $w =~ s/\.tmp$//; if ($success) { # success # uniq warn "\n" if $verbose && $pointflag; warn "sort -u > $whatisdb\n" if $verbose; foreach $i (sort @a) { if ($i ne $last) { push(@b, $i); } $last =$i; } $counter = $#b + 1; print @b; close A; select STDOUT; if (!$outfile) { warn "Rename $whatisdb to $w\n" if $verbose; rename($whatisdb, $w) || warn "rename $whatisdb $w\n"; $counter_all += $counter; warn "$counter entries in $w\n" if $verbose; } else { $counter_all = $counter; } } else { # building whatisdb failed unlink($whatisdb); warn "building whatisdb: $whatisdb failed\n" if $verbose; } return 1; } sub parse_subdir { local($dir) = @_; local($file, $dev,$ino); warn "\n" if $pointflag; warn "traverse $dir\n" if $verbose; $pointflag = 0; if (!opendir(M, $dir)) { warn "$dir: $!\n"; $err++; return 0; } $| = 1 if $verbose; foreach $file (readdir(M)) { next if $file =~ /^(\.|\.\.)$/; ($dev, $ino) = ((stat("$dir/$file"))[01]); if (-f _) { if ($man_red{"$dev.$ino"}) { # Link print STDERR "+" if $verbose; $pointflag++ if $verbose; } else { &manual("$dir/$file"); } $man_red{"$dev.$ino"} = 1; } elsif (! -d _) { warn "Cannot find file: $dir/$file\n"; $err++; } } closedir M; return 1; } # read man directory sub parse_dir { local($dir) = @_; local($subdir, $file); # clean up, in case mandir and subdirs are called simultaneously # e. g.: ~/man/man1 ~/man/man2 ~/man #~/man/ man1 and ~/man/man2 are a subset of ~/man foreach $file (keys %man_red) { delete $man_red{$file}; } if ($dir =~ /man/ || defined($locale) && ($dir =~ m|man/$locale$| || defined($locale1) && $dir =~ m|man/$locale1$| || defined($locale2) && $dir =~ m|man/$locale2$|)) { warn "\n" if $verbose && $pointflag; warn "open manpath directory ``$dir''\n" if $verbose; $pointflag = 0; if (!opendir(DIR, $dir)) { warn "opendir ``$dir'':$!\n"; $err = 1; return 0; } foreach $subdir (sort(readdir(DIR))) { if ($subdir =~ /^man\w+$/) { $subdir = "$dir/$subdir"; &parse_subdir($subdir); } } closedir DIR } elsif ($dir =~ /man\w+$/) { &parse_subdir($dir); } else { warn "Assume ``$dir'' is not a man directory.\n"; $err = 1; return 0; } return 1; } sub dir_redundant { local($dir) = @_; local ($dev,$ino) = (stat($dir))[0..1]; if ($dir_redundant{"$dev.$ino"}) { warn "$dir is equal to: $dir_redundant{\"$dev.$ino\"}\n" if $verbose; return 0; } $dir_redundant{"$dev.$ino"} = $dir; return 1; } # ``/usr/man/man1/foo.l'' -> ``l'' sub ext { local($filename) = @_; local($extension) = $filename; $extension =~ s/$ext$//g; # strip .gz $extension =~ s/.*\///g; # basename if ($extension !~ m%[^/]+\.[^.]+$%) { # no dot $extension = $filename; #$extension =~ s|/[^/]+$||; $extension =~ s%.*man([^/]+)/[^/]+%$1%; # last character warn "\n" if $verbose && $pointflag; warn "$filename has no extension, try section ``$extension''\n" if $verbose; $pointflag = 0; } else { $extension =~ s/.*\.//g; # foo.bla.1 -> 1 } return "$extension"; } # ``/usr/man/man1/foo.1'' -> ``foo'' sub name { local($name) = @_; $name =~ s=.*/==; $name =~ s=$ext$==o; $name =~ s=\.[^\.]+$==; return "$name"; } # output sub out { local($list) = @_; local($delim) = " - "; $_ = $list; # delete italic etc. s/^\.[^ -]+[ -]+//; s/\\\((em|mi)//; s/\\f[IRBP]//g; s/\\\*p//g; s/\(OBSOLETED\)[ ]?//; s/\\&//g; s/^\@INDOT\@//; s/[\"\\]//g; #" s/[. \t-]+$//; s/ / - / unless / - /; ($man,$desc) = split(/ - /); $man = $name unless $man; $man =~ s/[,. ]+$//; $man =~ s/,/($extension),/g; $man .= "($extension)"; &manpagename; $desc =~ s/^[ \t]+//; for($i = length($man); $i < $indent && $desc; $i++) { $man .= ' '; } if ($desc) { push(@a, "$man$delim$desc\n"); } else { push(@a, "$man\n"); } } # The filename of manual page is not a keyword. # This is bad, because you don't find the manpage # whith: $ man
# # Add filename if a) filename is not a keyword and b) no keyword(s) # exist as file in same mansection # sub manpagename { foreach (split(/,\s+/, $man)) { s/\(.+//; # filename is keyword return if $name eq $_; } local($f) = $file; $f =~ s%/*[^/]+$%%; # dirname local($e) = $file; $e =~ s/$ext$//; $e =~ s%.*(\.[^.]+)$%$1%; # .1 foreach (split(/,\s+/, $man)) { s/\(.+//; # a keyword exist as file return if -e "$f/$_$e" || -e "$f/$_$e$ext"; } $man = "$name($extension), $man"; } # looking for NAME sub manual { local($file) = @_; local($list, $desc, $extension); local($ofile) = $file; # Compressed man pages if ($ofile =~ /$ext$/) { $ofile = "gzcat $file |"; print STDERR "*" if $verbose; } else { print STDERR "." if $verbose; } $pointflag++ if $verbose; if (!open(F, "$ofile")) { warn "Cannot open file: $ofile\n"; $err++; return 0; } # extension/section $extension = &ext($file); $name = &name($file); local($source) = 0; local($list); while() { # ``man'' style pages # &&: it takes you only half the user time, regexp is slow!!! if (/^\.SH/ && /^\.SH[ \t]+["]?(NAME|Name|NAMN|BEZEICHNUNG|名称)["]?/) { #while() { last unless /^\./ } # Skip #chop; $list = $_; while() { last if /^\.SH[ \t]/; chop; s/^\.IX\s.*//; # delete perlpod garbage s/^\.[A-Z]+[ ]+[0-9]+$//; # delete commands s/^\.[A-Za-z]+[ \t]*//; # delete commands s/^\.\\".*$//; #" delete comments s/^[ \t]+//; if ($_) { $list .= $_; $list .= ' '; } } while() { } # skip remaining input to avoid pipe errors &out($list); close F; return 1; } elsif (/^\.Sh/ && /^\.Sh[ \t]+["]?(NAME|Name|BEZEICHNUNG|名称)["]?/) { # ``doc'' style pages local($flag) = 0; while() { last if /^\.Sh/; chop; s/^\.\\".*$//; #" delete comments if (/^\.Nm/) { s/^\.Nm[ \t]*//; s/ ,/,/g; s/[ \t]+$//; $list .= $_; $list .= ' '; } else { $list .= '- ' if (!$flag && !/^-/); $flag++; s/^\.[A-Z][a-z][ \t]*//; s/[ \t]+$//; $list .= $_; $list .= ' '; } } while() { } # skip remaining input to avoid pipe errors &out($list); close F; return 1; } elsif(/^\.so/ && /^\.so[ \t]+man/) { while() { } # skip remaining input to avoid pipe errors close F; return 1; } } if (!$source && $verbose) { warn "\n" if $pointflag; warn "Maybe $file is not a manpage\n" ; $pointflag = 0; } return 0; } # make relative path to absolute path sub absolute_path { local(@dirlist) = @_; local($pwd, $dir, @a); $pwd = $ENV{'PWD'}; foreach $dir (@dirlist) { if ($dir !~ "^/") { chop($pwd = `pwd`) if (!$pwd || $pwd !~ /^\//); push(@a, "$pwd/$dir"); } else { push(@a, $dir); } } return @a; } # strip unused '/' # e.g.: //usr///home// -> /usr/home sub stripdir { local($dir) = @_; $dir =~ s|/+|/|g; # delete double '/' $dir =~ s|/$||; # delete '/' at end $dir =~ s|/(\.\/)+|/|g; # delete ././././ $dir =~ s|/+|/|g; # delete double '/' $dir =~ s|/$||; # delete '/' at end $dir =~ s|/\.$||; # delete /. at end return $dir if $dir ne ""; return '/'; } sub variables { $verbose = 0; # Verbose $indent = 24; # indent for description $outfile = 0; # Don't write to ./whatis $whatis_name = "whatis"; # Default name for DB $append = 0; # Don't delete old entries # if no argument for directories given if (defined($locale)) { @defaultmanpath = ( ); push(@defaultmanpath, '/usr/share/man/' . $locale) if (-e '/usr/share/man/' . $locale && -d _); push(@defaultmanpath, '/usr/share/man/' . $locale1) if (defined($locale1) && -e '/usr/share/man/' . $locale1 && -d _); push(@defaultmanpath, '/usr/share/man/' . $locale2) if (defined($locale2) && -e '/usr/share/man/' . $locale2 && -d _); } else { @defaultmanpath = ( '/usr/share/man' ); } $ext = '.gz'; # extension umask(022); $err = 0; # exit code $whatisdb = ''; $counter_all = 0; $dir_redundant = ''; # redundant directories $man_red = ''; # redundant man pages @a = (); # Array for output # Signals $SIG{'INT'} = 'Exit'; $SIG{'HUP'} = 'Exit'; $SIG{'TRAP'} = 'Exit'; $SIG{'QUIT'} = 'Exit'; $SIG{'TERM'} = 'Exit'; $tmp = ''; # tmp file $ENV{'PATH'} = "/bin:/usr/bin:$ENV{'PATH'}"; } sub Exit { unlink($tmp) if $tmp ne ""; # unlink if a filename die "$0: die on signal SIG@_\n"; } sub parse { local(@argv) = @_; local($i); while ($_ = $argv[0], /^-/) { shift @argv; last if /^--$/; if (/^--?(v|verbose)$/) { $verbose = 1 } elsif (/^--?(h|help|\?)$/) { &usage } elsif (/^--?(o|outfile)$/) { $outfile = $argv[0]; shift @argv } elsif (/^--?(f|format|i|indent)$/) { $i = $argv[0]; shift @argv } elsif (/^--?(n|name)$/) { $whatis_name = $argv[0];shift @argv } elsif (/^--?(a|append)$/) { $append = 1 } else { &usage } } if ($i ne "") { if ($i =~ /^[0-9]+$/) { $indent = $i; } else { warn "Ignoring wrong indent value: ``$i''\n"; } } return &absolute_path(@argv) if $#argv >= 0; return @defaultmanpath if $#defaultmanpath >= 0; warn "Missing directories\n"; &usage; } ## ## Main ## # set locale if (defined($ENV{'LC_ALL'})) { $locale = $ENV{'LC_ALL'}; } elsif (defined($ENV{'LC_CTYPE'})) { $locale = $ENV{'LC_CTYPE'}; } elsif (defined($ENV{'LANG'})) { $locale = $ENV{'LANG'}; } else { undef $locale; } if (defined($locale)) { if ($locale =~ /^.._..\../) { $locale1 = substr($locale, 0, 5); } else { undef $locale1; } if ($locale =~ /^.._../) { $locale2 = substr($locale, 0, 2); } else { undef $locale2; } } &variables; # allow colons in dir: ``makewhatis dir1:dir2:dir3'' @argv = &parse(split(/[: ]/, join($", @ARGV))); # " if ($outfile) { if(&open_output($outfile)){ foreach $dir (@argv) { $dir = &stripdir($dir); &dir_redundant($dir) && &parse_dir($dir); } } &close_output(1); } else { foreach $dir (@argv) { $dir = &stripdir($dir); &dir_redundant($dir) && &close_output(&open_output($dir) && &parse_dir($dir)); } } warn "Total entries: $counter_all\n" if $verbose && ($#argv > 0 || $outfile); exit $err; jp-man-1.1j/makewhatis/jmakewhatis.local.man.eng100644 5777 310 5647 7230552400 20471 0ustar tkumanoslt.\" Copyright (c) April 1996 Wolfram Schneider . Berlin. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" $FreeBSD: /home/ncvs/src/gnu/usr.bin/man/makewhatis/makewhatis.local.8,v 1.10 2000/12/14 11:40:41 ru Exp $ .\" .\" Japanized by .\" Copyright (c) KUMANO, Tadashi , 1996-2001, .\" which is a study toward the multilingual enhancement. .\" (version 1.1i 2001/01/15) .\" .Dd January 15, 2001 .Dt JMAKEWHATIS.LOCAL 8 .Os FreeBSD .Sh NAME .Nm jmakewhatis.local , jcatman.local .Nd start .Nm jmakewhatis or .Nm jcatman.local for local file systems .Sh SYNOPSIS .Nm /usr/local/libexec/jmakewhatis.local .Op options .Ar directories ... .Nm /usr/local/libexec/jcatman.local .Op options .Ar directories ... .Sh DESCRIPTION .Nm start .Xr jmakewhatis 1 only for file systems physically mounted on the system where the .Nm is being executed. Running .Nm jmakewhatis by .Pa periodic weekly for rw nfs-mounted /usr may kill your NFS server -- all NFS clients start .Nm jmakewhatis at the same time! So use this wrapper for .Xr cron 8 instead of calling .Nm jmakewhatis directly. .Nm jcatman.local is using for same purposes as .Nm but for .Xr jcatman 1 . .\" .Sh FILES .\" .Bl -tag -width /etc/periodic/weekly/320.whatis.XXX -compact .\" .It Pa /etc/periodic/weekly/320.whatis .\" run .\" .Nm makewhatis.local .\" every week .\" .It Pa /etc/periodic/weekly/330.catman .\" run .\" .Nm catman.local .\" every week .\" .El .Sh SEE ALSO .Xr cron 8 , .Xr find 1 , .Xr jcatman 1 , .Xr jmakewhatis 1 , .Xr periodic 8 . .Sh HISTORY The .Nm makewhatis.local command appeared in .Fx 2.2 . Japanized .Nm command appeared in ports/packages collection of FreeBSD 2.2. jp-man-1.1j/makewhatis/jmakewhatis.local.man100644 5777 310 6066 7230552254 17724 0ustar tkumanoslt.\" Copyright (c) April 1996 Wolfram Schneider . Berlin. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" $FreeBSD: /home/ncvs/src/gnu/usr.bin/man/makewhatis/makewhatis.local.8,v 1.10 2000/12/14 11:40:41 ru Exp $ .\" .\" Japanized by .\" Copyright (c) KUMANO, Tadashi , 1996-2001, .\" which is a study toward the multilingual enhancement. .\" (version 1.1i 2001/01/15) .\" .Dd January 15, 2001 .Dt JMAKEWHATIS.LOCAL 8 .Os FreeBSD .Sh 名称 .Nm jmakewhatis.local , jcatman.local .Nd .Nm jmakewhatis や .Nm jcatman をローカルファイルシステム用に起動する。 .Sh 書式 .Nm /usr/local/libexec/jmakewhatis.local .Op options .Ar directories ... .Nm /usr/local/libexec/jcatman.local .Op options .Ar directories ... .Sh 解説 .Nm は、このプログラムが起動されたシステムに物理的にマウントされたファイルシステムに対してのみ、 .Xr jmakewhatis 1 を実行します。 毎週決まった時刻に .Nm jmakewhatis を読み書き可能な NFS マウントされた /usr パーティションに対して行うと、 全ての NFS クライアントが同じ時間に .Nm jmakewhatis を開始してしまい、 NFS サーバに非常に高い負荷がかかってしまいます。 ですから、 .Xr cron 8 では直接 .Nm jmakewhatis を起動するのではなく、 代わりにこのラッパプログラムを使ってください。 .Nm jcatman.local は .Xr jcatman 1 用の .Nm と同じ用途のプログラムです。 .\" .Sh 関連ファイル .\" .Bl -tag -width /etc/periodic/weekly/320.whatis.XXX -compact .\" .It Pa /etc/periodic/weekly/320.whatis .\" .Nm makewhatis.local .\" を毎週実行します。 .\" .It Pa /etc/periodic/weekly/330.catman .\" .Nm catman.local .\" を毎週実行します。 .\" .El .Sh 関連項目 .Xr find 1 , .Xr cron 8 , .Xr jcatman 1 , .Xr jmakewhatis 1 , .Xr periodic 8 . .Sh 歴史 このオリジナルの .Nm makewhatis.local コマンドは FreeBSD 2.2 から登場しました。 日本語版の .Nm コマンドは FreeBSD 2.2 から ports/packages として登場しました。 jp-man-1.1j/makewhatis/jmakewhatis.man100644 5777 310 11053 7311123761 16640 0ustar tkumanoslt.\" Copyright (c) 1994-1996 Wolfram Schneider . Berlin. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" $FreeBSD: src/gnu/usr.bin/man/makewhatis/makewhatis.1,v 1.18 2001/02/01 16:26:41 ru Exp $ .\" .\" Japanized by .\" Copyright (c) KUMANO, Tadashi , 1996-2001, .\" Copyright (c) FreeBSD jp-man project , 1996, 1998, .\" which is a study toward the multilingual enhancement. .\" (version 1.1j 2001/06/11) .\" .Dd June 11, 2001 .Dt JMAKEWHATIS 1 .Os FreeBSD .Sh 名称 .Nm jmakewhatis .Nd 日本語マニュアルページを含めたマニュアルページ用の whatis データベースを作成する .Sh 書式 .Nm jmakewhatis .Op Fl a | Fl append .Op Fl h | Fl help .Op Fl i | Fl indent Ar column .Op Fl n | Fl name Ar name .Op Fl o | Fl outfile Ar file .Op Fl v | Fl verbose .Op Ar directories ... .Sh 解説 .Nm jmakewhatis はフォーマットされていないマニュアルページから名称と短い解説を抽出し、 .Xr whatis 1 データベースを作成します。 .Nm jmakewhatis コマンドはgzipされたマニュアルページを読むことができます。 .Ar directory は、 .Pq Pa man.+ という名前の マニュアルページサブディレクトリを持つディレクトリの名前です。 コロンは空白と同様に扱われますので、 .Ic jmakewhatis $MANPATH や .Ic jmakewhatis `manpath` も許されます。 日本語マニュアルページサブディレクトリを持つディレクトリを .Ar directory に指定するときには、環境変数 LC_CTYPE か LANG を ja_JP.EUC に設定しておく必要があります。 .Sh オプション .Bl -tag -width Ds .It Fl a , Fl append アペンドモード。 whatis データベースの古いエントリを削除しません。 注意: 新しくできたデータベースは重複行がないようにソートされます。 また、古いエントリが妥当であるかはチェックしません。 .It Fl h , Fl help 使用可能なオプションを表示し、終了します。 .It Fl i , Fl indent Ar column 解説の文字列の長さを .Ar column にします Pq デフォルトは 24 です 。 .It Fl o , Fl outfile Ar file .Pa dirname/whatis の代わりに全ての出力を .Ar file に書き込みます。 .It Fl n , Fl name Ar name .Pa whatis の代わりに .Ar name を使用します。 .It Fl v , Fl verbose 多くの警告を .Pq 標準エラー出力に対して 出力します。 パースした全てのマニュアルに対して次の 1 文字を表示します: .Ql .\& は圧縮されていないページ、 .Ql * は圧縮されているページ、 .Ql + はリンクをそれぞれ表します。 .Sh 使用例 .Pp .Ic jmakewhatis $MANPATH .Pp ユーザの .Pa $MANPATH にある全てのディレクトリに対して whatis データベースを作成します。 .Pp .Ic jmakewhatis -outfile /tmp/mywhatis /usr/share/man/ja $HOME/man .Pp whatis データベース .Pa /tmp/mywhatis を作成します。 ディレクトリは .Pa /usr/share/man/ja と .Pa $HOME/man を見ます。 .Pa /usr/share/man/ja/whatis および .Pa $HOME/man/whatis は作成しません。 .Pp .Ic jmakewhatis -name windex $HOME/man .Pp .Pa whatis の代わりに jwhatis データベース .Pa windex を作成します。 おそらく Solaris で有効です。 .\" .Sh 関連ファイル .\" .Bl -tag -width */man/whatis -compact .\" .It Pa */man/whatis .\" whatis データベース。 .\" .It Pa /etc/periodic/weekly/320.whatis .\" 毎週 .\" .Nm .\" を実行します。 .\" .El .Sh 関連項目 .Xr japropos 1 , .Xr jcatman 1 , .Xr jmakewhatis.local 1 , .Xr jman 1 , .Xr jmanpath 1 , .Xr jwhatis 1 , .Xr sort 1 , .Xr uniq 1 .Sh 歴史 このオリジナルの .Nm makewhatis コマンドは FreeBSD 2.1 から登場しました。 日本語版の .Nm jmakewhatis コマンドは FreeBSD 2.2 から ports/packages として登場しました。 .Sh 作者 .An Wolfram Schneider , Berlin. .Sh 日本語対応 .An 熊野 正 jp-man-1.1j/makewhatis/jmakewhatis.man.eng100644 5777 310 10505 7311123755 17414 0ustar tkumanoslt.\" Copyright (c) 1994-1996 Wolfram Schneider . Berlin. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" $FreeBSD: src/gnu/usr.bin/man/makewhatis/makewhatis.1,v 1.18 2001/02/01 16:26:41 ru Exp $ .\" .\" Japanized by .\" Copyright (c) KUMANO, Tadashi , 1996-2001, .\" Copyright (c) FreeBSD jp-man project , 1996, 1998, .\" which is a study toward the multilingual enhancement. .\" (version 1.1j 2001/06/11) .\" .Dd June 11, 2001 .Dt JMAKEWHATIS 1 .Os FreeBSD .Sh NAME .Nm jmakewhatis .Nd create Japanese or original (English) whatis database .Sh SYNOPSIS .Nm .Op Fl a | Fl append .Op Fl h | Fl help .Op Fl i | Fl indent Ar column .Op Fl n | Fl name Ar name .Op Fl o | Fl outfile Ar file .Op Fl v | Fl verbose .Op Ar directories ... .Sh DESCRIPTION .Nm Jmakewhatis extracts the name and a short description from unformatted manpages and creates the .Xr japanese whatis 1 database. .Nm Jmakewhatis can read gzip'ed manpages. .Ar Directory names a directory containing manpage subdirectories .Pq named Pa man.+ . Colons are treated as spaces, hence .Ic jmakewhatis $MANPATH or .Ic jmakewhatis `manpath` are allowed. You have to set the environment variable LC_CTYPE (or LANG) to ja_JP.EUC if .Ar directory contains Japanese manpage subdirectories. .Sh OPTIONS .Bl -tag -width Ds .It Fl a , Fl append Append mode. Don't delete old entries in whatis database. Note: the new database will be sorted without repeated lines and .Nm does not check if old entries are valid. .It Fl h , Fl help Print options and exit. .It Fl i , Fl indent Ar column Justify description strings to .Ar column Pq default 24 . .It Fl n , Fl name Ar name Use .Ar name instead of .Pa whatis Ns . .It Fl o , Fl outfile Ar file Write all output to .Ar file instead of .Pa dirname/whatis Ns . .It Fl v , Fl verbose Issue more warnings .Pq to stderr . For every parsed man page write a single char: .Ql .\& for an uncompressed page, .Ql * for a compressed page, and .Ql + for a link. .El .Sh EXAMPLES .Pp .Ic jmakewhatis $MANPATH .Pp Create whatis database for all directories in your .Pa $MANPATH Ns . .Pp .Ic jmakewhatis -outfile /tmp/mywhatis /usr/share/man/ja $HOME/man .Pp Create whatis database .Pa /tmp/mywhatis . Traverse directories .Pa /usr/share/man/ja and .Pa $HOME/man Ns . Don't create .Pa /usr/share/man/ja/whatis or .Pa $HOME/man/whatis Ns . .Pp .Ic jmakewhatis -name windex $HOME/man .Pp Create whatis database .Pa windex instead of .Pa whatis Ns . May be useful for Solaris. .\" .Sh FILES .\" .Bl -tag -width /etc/master.passwdxx -compact .\" .It Pa */man/whatis .\" whatis database .\" .It Pa /etc/periodic/weekly/320.whatis .\" run .\" .Nm makewhatis.local .\" every week .\" .El .Sh SEE ALSO .Xr japropos 1 , .Xr jcatman 1 , .Xr jmakewhatis.local 1 , .Xr jman 1 , .Xr jmanpath 1 , .Xr jwhatis 1 , .Xr sort 1 , .Xr uniq 1 . .Sh HISTORY The original version of .Nm makewhatis command appeared in FreeBSD 2.1. Japanized .Nm jmakewhatis command appeared in ports/packages collection of FreeBSD 2.2. .Sh AUTHORS .An Wolfram Schneider , Berlin. .Sh JAPANIZATION .An KUMANO, Tadashi jp-man-1.1j/man/ 40755 5777 310 0 7312533311 12132 5ustar tkumanosltjp-man-1.1j/man/version.h100644 5777 310 1075 7311133426 14072 0ustar tkumanoslt/* * version.h * * Copyright (c) 1990, 1991, John W. Eaton. * * You may distribute under the terms of the GNU General Public * License as specified in the file COPYING that comes with the man * distribution. * * John W. Eaton * jwe@che.utexas.edu * Department of Chemical Engineering * The University of Texas at Austin * Austin, Texas 78712 * * Japanized by * Copyright (c) KUMANO, Tadashi , 1996-2001, * which is a study toward the multilingual enhancement. * (version 1.1j 2001/06/11) */ static char version[] = "1.1-J1.1j"; jp-man-1.1j/man/glob.c100644 5777 310 37414 6437732446 13370 0ustar tkumanoslt/* File-name wildcard pattern matching for GNU. Copyright (C) 1985, 1988, 1989, 1990, 1991 Free Software Foundation, Inc. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 1, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ /* To whomever it may concern: I have never seen the code which most Unix programs use to perform this function. I wrote this from scratch based on specifications for the pattern matching. --RMS. */ #ifdef SHELL #include "config.h" #endif /* SHELL */ #include #if defined (USGr3) && !defined (DIRENT) #define DIRENT #endif /* USGr3 */ #if defined (Xenix) && !defined (SYSNDIR) #define SYSNDIR #endif /* Xenix */ #if defined (POSIX) || defined (DIRENT) || defined (__GNU_LIBRARY__) #include #define direct dirent #define D_NAMLEN(d) strlen((d)->d_name) #else /* not POSIX or DIRENT or __GNU_LIBRARY__ */ #define D_NAMLEN(d) ((d)->d_namlen) #ifdef USG #if defined (SYSNDIR) #include #else /* SYSNDIR */ #include "ndir.h" #endif /* not SYSNDIR */ #else /* not USG */ #include #endif /* USG */ #endif /* POSIX or DIRENT or __GNU_LIBRARY__ */ #if defined (_POSIX_SOURCE) /* Posix does not require that the d_ino field be present, and some systems do not provide it. */ #define REAL_DIR_ENTRY(dp) 1 #else #define REAL_DIR_ENTRY(dp) (dp->d_ino != 0) #endif /* _POSIX_SOURCE */ #if defined (STDC_HEADERS) || defined (__GNU_LIBRARY__) #include #include #define STDC_STRINGS #else /* STDC_HEADERS or __GNU_LIBRARY__ */ #if defined (USG) #include #ifndef POSIX #include #endif /* POSIX */ #define STDC_STRINGS #else /* not USG */ #ifdef NeXT #include #else /* NeXT */ #include #endif /* NeXT */ /* Declaring bcopy causes errors on systems whose declarations are different. If the declaration is omitted, everything works fine. */ #endif /* not USG */ extern char *malloc (); extern char *realloc (); extern void free (); #ifndef NULL #define NULL 0 #endif #endif /* Not STDC_HEADERS or __GNU_LIBRARY__. */ #ifdef STDC_STRINGS #define bcopy(s, d, n) memcpy ((d), (s), (n)) #define index strchr #define rindex strrchr #endif /* STDC_STRINGS */ #ifndef alloca #ifdef __GNUC__ #define alloca __builtin_alloca #else /* Not GCC. */ #ifdef sparc #include #else /* Not sparc. */ extern char *alloca (); #endif /* sparc. */ #endif /* GCC. */ #endif /* Nonzero if '*' and '?' do not match an initial '.' for glob_filename. */ int noglob_dot_filenames = 1; static int glob_match_after_star (); #ifdef __FreeBSD__ static int collate_range_cmp (a, b) int a, b; { int r; static char s[2][2]; if ((unsigned char)a == (unsigned char)b) return 0; s[0][0] = a; s[1][0] = b; if ((r = strcoll(s[0], s[1])) == 0) r = (unsigned char)a - (unsigned char)b; return r; } #endif /* Return nonzero if PATTERN has any special globbing chars in it. */ int glob_pattern_p (pattern) char *pattern; { register char *p = pattern; register char c; int open = 0; while ((c = *p++) != '\0') switch (c) { case '?': case '*': return 1; case '[': /* Only accept an open brace if there is a close */ open++; /* brace to match it. Bracket expressions must be */ continue; /* complete, according to Posix.2 */ case ']': if (open) return 1; continue; case '\\': if (*p++ == '\0') return 0; } return 0; } /* Match the pattern PATTERN against the string TEXT; return 1 if it matches, 0 otherwise. A match means the entire string TEXT is used up in matching. In the pattern string, `*' matches any sequence of characters, `?' matches any character, [SET] matches any character in the specified set, [!SET] matches any character not in the specified set. A set is composed of characters or ranges; a range looks like character hyphen character (as in 0-9 or A-Z). [0-9a-zA-Z_] is the set of characters allowed in C identifiers. Any other character in the pattern must be matched exactly. To suppress the special syntactic significance of any of `[]*?!-\', and match the character exactly, precede it with a `\'. If DOT_SPECIAL is nonzero, `*' and `?' do not match `.' at the beginning of TEXT. */ int glob_match (pattern, text, dot_special) char *pattern, *text; int dot_special; { register char *p = pattern, *t = text; register char c; while ((c = *p++) != '\0') switch (c) { case '?': if (*t == '\0' || (dot_special && t == text && *t == '.')) return 0; else ++t; break; case '\\': if (*p++ != *t++) return 0; break; case '*': if (dot_special && t == text && *t == '.') return 0; return glob_match_after_star (p, t); case '[': { register char c1 = *t++; int invert; char *cp1 = p; if (c1 == '\0') return 0; invert = (*p == '!'); if (invert) p++; c = *p++; while (1) { register char cstart = c, cend = c; if (c == '\\') { cstart = *p++; cend = cstart; } if (cstart == '\0') { /* Missing ']'. */ if (c1 != '[') return 0; /* matched a single bracket */ p = cp1; goto breakbracket; } c = *p++; if (c == '-') { cend = *p++; if (cend == '\\') cend = *p++; if (cend == '\0') return 0; c = *p++; } #ifdef __FreeBSD__ if ( collate_range_cmp (c1, cstart) >= 0 && collate_range_cmp (c1, cend) <= 0 ) #else if (c1 >= cstart && c1 <= cend) #endif goto match; if (c == ']') break; } if (!invert) return 0; break; match: /* Skip the rest of the [...] construct that already matched. */ while (c != ']') { if (c == '\0') return 0; c = *p++; if (c == '\0') return 0; if (c == '\\') p++; } if (invert) return 0; breakbracket: break; } default: if (c != *t++) return 0; } return *t == '\0'; } /* Like glob_match, but match PATTERN against any final segment of TEXT. */ static int glob_match_after_star (pattern, text) char *pattern, *text; { register char *p = pattern, *t = text; register char c, c1; while ((c = *p++) == '?' || c == '*') if (c == '?' && *t++ == '\0') return 0; if (c == '\0') return 1; if (c == '\\') c1 = *p; else c1 = c; --p; while (1) { if ((c == '[' || *t == c1) && glob_match (p, t, 0)) return 1; if (*t++ == '\0') return 0; } } /* Return a vector of names of files in directory DIR whose names match glob pattern PAT. The names are not in any particular order. Wildcards at the beginning of PAT do not match an initial period if noglob_dot_filenames is nonzero. The vector is terminated by an element that is a null pointer. To free the space allocated, first free the vector's elements, then free the vector. Return NULL if cannot get enough memory to hold the pointer and the names. Return -1 if cannot access directory DIR. Look in errno for more information. */ char ** glob_vector (pat, dir) char *pat; char *dir; { struct globval { struct globval *next; char *name; }; DIR *d; register struct direct *dp; struct globval *lastlink; register struct globval *nextlink; register char *nextname; unsigned int count; int lose; register char **name_vector; register unsigned int i; #ifdef ALLOCA_MISSING struct globval *templink; #endif d = opendir (dir); if (d == NULL) return (char **) -1; lastlink = NULL; count = 0; lose = 0; /* Scan the directory, finding all names that match. For each name that matches, allocate a struct globval on the stack and store the name in it. Chain those structs together; lastlink is the front of the chain. */ while (1) { #if defined (SHELL) /* Make globbing interruptible in the bash shell. */ extern int interrupt_state; if (interrupt_state) { closedir (d); lose = 1; goto lost; } #endif /* SHELL */ dp = readdir (d); if (dp == NULL) break; if (REAL_DIR_ENTRY (dp) && glob_match (pat, dp->d_name, noglob_dot_filenames)) { #ifdef ALLOCA_MISSING nextlink = (struct globval *) malloc (sizeof (struct globval)); #else nextlink = (struct globval *) alloca (sizeof (struct globval)); #endif nextlink->next = lastlink; i = D_NAMLEN (dp) + 1; nextname = (char *) malloc (i); if (nextname == NULL) { lose = 1; break; } lastlink = nextlink; nextlink->name = nextname; bcopy (dp->d_name, nextname, i); count++; } } closedir (d); if (!lose) { name_vector = (char **) malloc ((count + 1) * sizeof (char *)); lose |= name_vector == NULL; } /* Have we run out of memory? */ #ifdef SHELL lost: #endif if (lose) { /* Here free the strings we have got. */ while (lastlink) { free (lastlink->name); #ifdef ALLOCA_MISSING templink = lastlink->next; free ((char *) lastlink); lastlink = templink; #else lastlink = lastlink->next; #endif } return NULL; } /* Copy the name pointers from the linked list into the vector. */ for (i = 0; i < count; ++i) { name_vector[i] = lastlink->name; #ifdef ALLOCA_MISSING templink = lastlink->next; free ((char *) lastlink); lastlink = templink; #else lastlink = lastlink->next; #endif } name_vector[count] = NULL; return name_vector; } /* Return a new array, replacing ARRAY, which is the concatenation of each string in ARRAY to DIR. Return NULL if out of memory. */ static char ** glob_dir_to_array (dir, array) char *dir, **array; { register unsigned int i, l; int add_slash = 0; char **result; l = strlen (dir); if (l == 0) return array; if (dir[l - 1] != '/') add_slash++; for (i = 0; array[i] != NULL; i++) ; result = (char **) malloc ((i + 1) * sizeof (char *)); if (result == NULL) return NULL; for (i = 0; array[i] != NULL; i++) { result[i] = (char *) malloc (1 + l + add_slash + strlen (array[i])); if (result[i] == NULL) return NULL; strcpy (result[i], dir); if (add_slash) result[i][l] = '/'; strcpy (result[i] + l + add_slash, array[i]); } result[i] = NULL; /* Free the input array. */ for (i = 0; array[i] != NULL; i++) free (array[i]); free ((char *) array); return result; } /* Do globbing on PATHNAME. Return an array of pathnames that match, marking the end of the array with a null-pointer as an element. If no pathnames match, then the array is empty (first element is null). If there isn't enough memory, then return NULL. If a file system error occurs, return -1; `errno' has the error code. Wildcards at the beginning of PAT, or following a slash, do not match an initial period if noglob_dot_filenames is nonzero. */ char ** glob_filename (pathname) char *pathname; { char **result; unsigned int result_size; char *directory_name, *filename; unsigned int directory_len; result = (char **) malloc (sizeof (char *)); result_size = 1; if (result == NULL) return NULL; result[0] = NULL; /* Find the filename. */ filename = rindex (pathname, '/'); if (filename == NULL) { filename = pathname; directory_name = ""; directory_len = 0; } else { directory_len = (filename - pathname) + 1; #ifdef ALLOCA_MISSING directory_name = (char *) malloc (directory_len + 1); #else directory_name = (char *) alloca (directory_len + 1); #endif bcopy (pathname, directory_name, directory_len); directory_name[directory_len] = '\0'; ++filename; } /* If directory_name contains globbing characters, then we have to expand the previous levels. Just recurse. */ if (glob_pattern_p (directory_name)) { char **directories; register unsigned int i; if (directory_name[directory_len - 1] == '/') directory_name[directory_len - 1] = '\0'; directories = glob_filename (directory_name); #ifdef ALLOCA_MISSING free ((char *) directory_name); #endif if (directories == NULL) goto memory_error; else if (directories == (char **) -1) return (char **) -1; else if (*directories == NULL) { free ((char *) directories); return (char **) -1; } /* We have successfully globbed the preceding directory name. For each name in DIRECTORIES, call glob_vector on it and FILENAME. Concatenate the results together. */ for (i = 0; directories[i] != NULL; i++) { char **temp_results = glob_vector (filename, directories[i]); if (temp_results == NULL) goto memory_error; else if (temp_results == (char **) -1) /* This filename is probably not a directory. Ignore it. */ ; else { char **array = glob_dir_to_array (directories[i], temp_results); register unsigned int l; l = 0; while (array[l] != NULL) ++l; result = (char **) realloc (result, (result_size + l) * sizeof (char *)); if (result == NULL) goto memory_error; for (l = 0; array[l] != NULL; ++l) result[result_size++ - 1] = array[l]; result[result_size - 1] = NULL; free ((char *) array); } } /* Free the directories. */ for (i = 0; directories[i] != NULL; i++) free (directories[i]); free ((char *) directories); return result; } /* If there is only a directory name, return it. */ if (*filename == '\0') { result = (char **) realloc ((char *) result, 2 * sizeof (char *)); if (result != NULL) { result[0] = (char *) malloc (directory_len + 1); if (result[0] == NULL) { #ifdef ALLOCA_MISSING free ((char *) directory_name); #endif goto memory_error; } bcopy (directory_name, result[0], directory_len + 1); result[1] = NULL; } #ifdef ALLOCA_MISSING free ((char *) directory_name); #endif return result; } else { /* Otherwise, just return what glob_vector returns appended to the directory name. */ char **temp_results = glob_vector (filename, (directory_len == 0 ? "." : directory_name)); if (temp_results == NULL || temp_results == (char **) -1) { #ifdef NO_ALLOCA free ((char *) directory_name); #endif return temp_results; } temp_results = glob_dir_to_array (directory_name, temp_results); #ifdef NO_ALLOCA free ((char *) directory_name); #endif return temp_results; } /* We get to memory error if the program has run out of memory, or if this is the shell, and we have been interrupted. */ memory_error: if (result != NULL) { register unsigned int i; for (i = 0; result[i] != NULL; ++i) free (result[i]); free ((char *) result); } #if defined (SHELL) { extern int interrupt_state; if (interrupt_state) throw_to_top_level (); } #endif /* SHELL */ return NULL; } #ifdef TEST main (argc, argv) int argc; char **argv; { char **value; int i, optind; for (optind = 1; optind < argc; optind++) { value = glob_filename (argv[optind]); if (value == NULL) puts ("virtual memory exhausted"); else if (value == (char **) -1) perror (argv[optind]); else for (i = 0; value[i] != NULL; i++) puts (value[i]); } exit (0); } #endif /* TEST */ jp-man-1.1j/man/man.c100644 5777 310 104436 7311141371 13216 0ustar tkumanoslt/* * man.c * * Copyright (c) 1990, 1991, John W. Eaton. * * You may distribute under the terms of the GNU General Public * License as specified in the file COPYING that comes with the man * distribution. * * John W. Eaton * jwe@che.utexas.edu * Department of Chemical Engineering * The University of Texas at Austin * Austin, Texas 78712 * * $FreeBSD: src/gnu/usr.bin/man/man/man.c,v 1.45 2001/02/19 14:19:57 ru Exp $ * * Japanized by * Copyright (c) KUMANO, Tadashi , 1996-2001, * which is a study toward the multilingual enhancement. * (version 1.1j 2001/06/11) */ #define MAN_MAIN #include #include #include #include #include #ifdef __FreeBSD__ #include #endif #include #include #include #include "config.h" #include "gripes.h" #include "version.h" #ifdef POSIX #include #else #ifndef R_OK #define R_OK 4 #endif #endif #ifdef SECURE_MAN_UID extern uid_t getuid (); extern int setuid (); #endif #ifdef STDC_HEADERS #include #else extern char *malloc (); extern char *getenv (); extern void free (); extern int system (); extern int strcmp (); extern int strncmp (); extern int exit (); extern int fflush (); extern int printf (); extern int fprintf (); extern FILE *fopen (); extern int fclose (); extern char *sprintf (); #endif extern char **glob_filename (); extern int is_newer (); extern int is_directory (); extern int do_system_command (); char *prognam; static char *pager; static char *machine; static char *manp; static char *manpathlist[MAXDIRS]; static char *section; static char *colon_sep_section_list; static char **section_list; static char *roff_directive; static int apropos; static int whatis; static int findall; static int print_where; #ifdef LOCALE static int force_original; #endif #ifdef ALT_SYSTEMS static int alt_system; static char *alt_system_name; #endif static int troff = 0; int debug; #ifdef HAS_TROFF #ifdef ALT_SYSTEMS #ifdef LOCALE static char args[] = "M:P:S:adfhkm:op:tw?"; #else static char args[] = "M:P:S:adfhkm:p:tw?"; #endif #else #ifdef LOCALE static char args[] = "M:P:S:adfhkop:tw?"; #else static char args[] = "M:P:S:adfhkp:tw?"; #endif #endif #else #ifdef ALT_SYSTEMS #ifdef LOCALE static char args[] = "M:P:S:adfhkm:op:w?"; #else static char args[] = "M:P:S:adfhkm:p:w?"; #endif #else #ifdef LOCALE static char args[] = "M:P:S:adfhkop:w?"; #else static char args[] = "M:P:S:adfhkp:w?"; #endif #endif #endif #ifdef SETREUID uid_t ruid; uid_t euid; gid_t rgid; gid_t egid; #endif #ifdef LOCALE static char *current_locale = NULL; #endif int main (argc, argv) int argc; char **argv; { int status = 0; char *nextarg; char *tmp; extern char *mkprogname (); char *is_section (); char **get_section_list (); void man_getopt (); void do_apropos (); void do_whatis (); int man (); prognam = mkprogname (argv[0]); unsetenv("IFS"); #ifdef __FreeBSD__ (void) setlocale(LC_ALL, ""); #endif #ifdef LOCALE (void)setlocale(LC_CTYPE, ""); current_locale = strdup(setlocale(LC_CTYPE, NULL)); #endif man_getopt (argc, argv); if (optind == argc) gripe_no_name ((char *)NULL); section_list = get_section_list (); if (optind == argc - 1) { tmp = is_section (argv[optind]); if (tmp != NULL) gripe_no_name (tmp); } #ifdef SETREUID ruid = getuid(); rgid = getgid(); euid = geteuid(); egid = getegid(); setreuid(-1, ruid); setregid(-1, rgid); #endif while (optind < argc) { nextarg = argv[optind++]; /* * See if this argument is a valid section name. If not, * is_section returns NULL. */ tmp = is_section (nextarg); if (tmp != NULL) { section = tmp; if (debug) fprintf (stderr, "\nsection: %s\n", section); continue; } if (apropos) { do_apropos (nextarg); status = (status ? 0 : 1); /* reverts status, see below */ } else if (whatis) { do_whatis (nextarg); status = (status ? 0 : 1); /* reverts status, see below */ } else { status = man (nextarg); if (status == 0) gripe_not_found (nextarg, section); } } return (status==0); /* status==1 --> exit(0), status==0 --> exit(1) */ } void usage () { static char usage_string[1024] = "%s, version %s\n\n"; #ifdef HAS_TROFF #ifdef ALT_SYSTEMS #ifdef LOCALE static char s1[] = "usage: %s [-adfhkotw] [section] [-M path] [-P pager] [-S list]\n\ [-m system] [-p string] name ...\n\n"; #else static char s1[] = "usage: %s [-adfhktw] [section] [-M path] [-P pager] [-S list]\n\ [-m system] [-p string] name ...\n\n"; #endif #else #ifdef LOCALE static char s1[] = "usage: %s [-adfhkotw] [section] [-M path] [-P pager] [-S list]\n\ [-p string] name ...\n\n"; #else static char s1[] = "usage: %s [-adfhktw] [section] [-M path] [-P pager] [-S list]\n\ [-p string] name ...\n\n"; #endif #endif #else #ifdef ALT_SYSTEMS #ifdef LOCALE static char s1[] = "usage: %s [-adfhkow] [section] [-M path] [-P pager] [-S list]\n\ [-m system] [-p string] name ...\n\n"; #else static char s1[] = "usage: %s [-adfhkw] [section] [-M path] [-P pager] [-S list]\n\ [-m system] [-p string] name ...\n\n"; #endif #else #ifdef LOCALE static char s1[] = "usage: %s [-adfhkow] [section] [-M path] [-P pager] [-S list]\n\ [-p string] name ...\n\n"; #else static char s1[] = "usage: %s [-adfhkw] [section] [-M path] [-P pager] [-S list]\n\ [-p string] name ...\n\n"; #endif #endif #endif static char s2[] = " a : find all matching entries\n\ d : print gobs of debugging information\n\ f : same as whatis(1)\n\ h : print this help message\n\ k : same as apropos(1)\n"; #ifdef LOCALE static char s22[] = " o : force looking up original manual\n"; #endif #ifdef HAS_TROFF static char s3[] = " t : use troff to format pages for printing\n"; #endif static char s4[] = " w : print location of man page(s) that would be displayed\n\n\ M path : set search path for manual pages to `path'\n\ P pager : use program `pager' to display pages\n\ S list : colon separated section list\n"; #ifdef ALT_SYSTEMS static char s5[] = " m system : search for alternate system's man pages\n"; #endif static char s6[] = " p string : string tells which preprocessors to run\n\ e - [n]eqn(1) p - pic(1) t - tbl(1)\n\ g - grap(1) r - refer(1) v - vgrind(1)\n"; strcat (usage_string, s1); strcat (usage_string, s2); #ifdef LOCALE strcat (usage_string, s22); #endif #ifdef HAS_TROFF strcat (usage_string, s3); #endif strcat (usage_string, s4); #ifdef ALT_SYSTEMS strcat (usage_string, s5); #endif strcat (usage_string, s6); fprintf (stderr, usage_string, prognam, version, prognam); exit(1); } char ** #ifdef LOCALE add_dir_to_mpath_list (mp, pp, locale) #else add_dir_to_mpath_list (mp, p) #endif char **mp; #ifdef LOCALE char *pp; int locale; #else char *p; #endif { int status; #ifdef LOCALE char *p; char *tmp_locale; int num_expand = 1; if (locale && (tmp_locale = strdup(current_locale)) != NULL) { if (tmp_locale[2] == '_') num_expand++; if (tmp_locale[5] == '.') num_expand++; } while (num_expand > 0) { if (locale) { static char buf[FILENAME_MAX]; snprintf(buf, (size_t)(FILENAME_MAX - 1), "%s/%s", pp, tmp_locale); p = buf; } else { p = pp; } #endif status = is_directory (p); if (status < 0 && debug) { fprintf (stderr, "Warning: couldn't stat file %s!\n", p); } else if (status == 0 && debug) { fprintf (stderr, "Warning: %s isn't a directory!\n", p); } else if (status == 1) { if (debug) fprintf (stderr, "adding %s to manpathlist\n", p); *mp++ = strdup (p); } #ifdef LOCALE num_expand--; if (locale) { if (num_expand > 1) { tmp_locale[5] = '\0'; } else if (num_expand > 0) { tmp_locale[2] = '\0'; } } } #endif return mp; } /* * Get options from the command line and user environment. */ void man_getopt (argc, argv) register int argc; register char **argv; { register int c; register char *p; register char *end; register char **mp; #ifdef LOCALE register int locale; #endif extern void downcase (); extern char *manpath (); while ((c = getopt (argc, argv, args)) != EOF) { switch (c) { case 'M': manp = strdup (optarg); break; case 'P': pager = strdup (optarg); if (setenv("PAGER", pager, 1) != 0) (void)fprintf(stderr, "setenv PAGER=%s\n", pager); break; case 'S': colon_sep_section_list = strdup (optarg); break; case 'a': findall++; break; case 'd': debug++; break; case 'f': if (troff) gripe_incompatible ("-f and -t"); if (apropos) gripe_incompatible ("-f and -k"); if (print_where) gripe_incompatible ("-f and -w"); whatis++; break; case 'k': if (troff) gripe_incompatible ("-k and -t"); if (whatis) gripe_incompatible ("-k and -f"); if (print_where) gripe_incompatible ("-k and -w"); apropos++; break; #ifdef ALT_SYSTEMS case 'm': alt_system++; alt_system_name = strdup (optarg); break; #endif #ifdef LOCALE case 'o': force_original++; break; #endif case 'p': roff_directive = strdup (optarg); break; #ifdef HAS_TROFF case 't': if (apropos) gripe_incompatible ("-t and -k"); if (whatis) gripe_incompatible ("-t and -f"); if (print_where) gripe_incompatible ("-t and -w"); troff++; break; #endif case 'w': if (apropos) gripe_incompatible ("-w and -k"); if (whatis) gripe_incompatible ("-w and -f"); if (troff) gripe_incompatible ("-w and -t"); print_where++; break; case 'h': case '?': default: usage(); break; } } if (pager == NULL || *pager == '\0') if ((pager = getenv ("PAGER")) == NULL) pager = strdup (PAGER); if (debug) fprintf (stderr, "\nusing %s as pager\n", pager); if ((machine = getenv ("MACHINE")) == NULL) machine = MACHINE; if (debug) fprintf (stderr, "\nusing %s architecture\n", machine); if (manp == NULL) { if ((manp = manpath (0)) == NULL) gripe_manpath (); if (debug) fprintf (stderr, "\nsearch path for pages determined by manpath is\n%s\n\n", manp); } #ifdef ALT_SYSTEMS if (alt_system_name == NULL || *alt_system_name == '\0') if ((alt_system_name = getenv ("SYSTEM")) != NULL) alt_system_name = strdup (alt_system_name); if (alt_system_name != NULL && *alt_system_name != '\0') downcase (alt_system_name); #endif /* * Expand the manpath into a list for easier handling. */ mp = manpathlist; #ifdef LOCALE for (locale = 1; locale >= 0; locale--) { if (locale && (force_original || !current_locale || *current_locale == '\0')) continue; #endif for (p = manp; ; p = end+1) { if (mp == manpathlist + MAXDIRS - 1) { fprintf (stderr, "Warning: too many directories in manpath, truncated!\n"); break; } if ((end = strchr (p, ':')) != NULL) *end = '\0'; #ifdef ALT_SYSTEMS if (alt_system) { char buf[FILENAME_MAX]; if (debug) fprintf (stderr, "Alternate system `%s' specified\n", alt_system_name); snprintf(buf, sizeof(buf), "%s/%s", p, alt_system_name); # ifdef LOCALE mp = add_dir_to_mpath_list (mp, buf, locale); # else mp = add_dir_to_mpath_list (mp, buf); # endif } else { # ifdef LOCALE mp = add_dir_to_mpath_list (mp, p, locale); # else mp = add_dir_to_mpath_list (mp, p); # endif } #else # ifdef LOCALE mp = add_dir_to_mpath_list (mp, p, locale); # else mp = add_dir_to_mpath_list (mp, p); # endif #endif if (end == NULL) break; *end = ':'; } #ifdef LOCALE } #endif *mp = NULL; } /* * Check to see if the argument is a valid section number. If the * first character of name is a numeral, or the name matches one of * the sections listed in section_list, we'll assume that it's a section. * The list of sections in config.h simply allows us to specify oddly * named directories like .../man3f. Yuk. */ char * is_section (name) register char *name; { register char **vs; for (vs = section_list; *vs != NULL; vs++) if ((strcmp (*vs, name) == 0) || (isdigit ((unsigned char)name[0]) && strlen(name) == 1)) return strdup (name); return NULL; } /* * Handle the apropos option. Cheat by using another program. */ void do_apropos (name) register char *name; { register int len; register char *command; len = strlen (APROPOS) + strlen (name) + 4; if ((command = (char *) malloc(len)) == NULL) gripe_alloc (len, "command"); sprintf (command, "%s \"%s\"", APROPOS, name); (void) do_system_command (command); free (command); } /* * Handle the whatis option. Cheat by using another program. */ void do_whatis (name) register char *name; { register int len; register char *command; len = strlen (WHATIS) + strlen (name) + 4; if ((command = (char *) malloc(len)) == NULL) gripe_alloc (len, "command"); sprintf (command, "%s \"%s\"", WHATIS, name); (void) do_system_command (command); free (command); } /* * Change a name of the form ...man/man1/name.1 to ...man/cat1/name.1 * or a name of the form ...man/cat1/name.1 to ...man/man1/name.1 */ char * convert_name (name, to_cat) register char *name; register int to_cat; { register char *to_name; register char *t1; register char *t2 = NULL; #ifdef DO_COMPRESS if (to_cat) { int olen = strlen(name); int cextlen = strlen(COMPRESS_EXT); int len = olen + cextlen; to_name = malloc (len+1); if (to_name == NULL) gripe_alloc (len+1, "to_name"); strcpy (to_name, name); olen -= cextlen; /* Avoid tacking it on twice */ if (olen >= 1 && strcmp(name + olen, COMPRESS_EXT) != 0) strcat (to_name, COMPRESS_EXT); } else to_name = strdup (name); #else to_name = strdup (name); #endif t1 = strrchr (to_name, '/'); if (t1 != NULL) { *t1 = '\0'; t2 = strrchr (to_name, '/'); *t1 = '/'; /* Skip architecture part (if present). */ if (t2 != NULL && (t1 - t2 < 5 || *(t2 + 1) != 'm' || *(t2 + 3) != 'n')) { t1 = t2; *t1 = '\0'; t2 = strrchr (to_name, '/'); *t1 = '/'; } } if (t2 == NULL) gripe_converting_name (name, to_cat); if (to_cat) { *(++t2) = 'c'; *(t2+2) = 't'; } else { *(++t2) = 'm'; *(t2+2) = 'n'; } if (debug) fprintf (stderr, "to_name in convert_name () is: %s\n", to_name); return to_name; } /* * Try to find the man page corresponding to the given name. The * reason we do this with globbing is because some systems have man * page directories named man3 which contain files with names like * XtPopup.3Xt. Rather than requiring that this program know about * all those possible names, we simply try to match things like * .../man[sect]/name[sect]*. This is *much* easier. * * Note that globbing is only done when the section is unspecified. */ char ** glob_for_file (path, section, name, cat) register char *path; register char *section; register char *name; register int cat; { char pathname[FILENAME_MAX]; char **gf; if (cat) snprintf (pathname, sizeof(pathname), "%s/cat%s/%s.%s*", path, section, name, section); else snprintf (pathname, sizeof(pathname), "%s/man%s/%s.%s*", path, section, name, section); if (debug) fprintf (stderr, "globbing %s\n", pathname); gf = glob_filename (pathname); if ((gf == (char **) -1 || *gf == NULL) && isdigit ((unsigned char)*section)) { if (cat) snprintf (pathname, sizeof(pathname), "%s/cat%s/%s.%c*", path, section, name, *section); else snprintf (pathname, sizeof(pathname), "%s/man%s/%s.%c*", path, section, name, *section); gf = glob_filename (pathname); } if ((gf == (char **) -1 || *gf == NULL) && isdigit ((unsigned char)*section)) { if (cat) snprintf (pathname, sizeof(pathname), "%s/cat%s/%s.0*", path, section, name); else snprintf (pathname, sizeof(pathname), "%s/man%s/%s.0*", path, section, name); if (debug) fprintf (stderr, "globbing %s\n", pathname); gf = glob_filename (pathname); } return gf; } /* * Return an un-globbed name in the same form as if we were doing * globbing. */ char ** make_name (path, section, name, cat) register char *path; register char *section; register char *name; register int cat; { register int i = 0; static char *names[3]; char buf[FILENAME_MAX]; if (cat) snprintf (buf, sizeof(buf), "%s/cat%s/%s.%s", path, section, name, section); else snprintf (buf, sizeof(buf), "%s/man%s/%s.%s", path, section, name, section); if (access (buf, R_OK) == 0) names[i++] = strdup (buf); /* * If we're given a section that looks like `3f', we may want to try * file names like .../man3/foo.3f as well. This seems a bit * kludgey to me, but what the hey... */ if (section[1] != '\0') { if (cat) snprintf (buf, sizeof(buf), "%s/cat%c/%s.%s", path, section[0], name, section); else snprintf (buf, sizeof(buf), "%s/man%c/%s.%s", path, section[0], name, section); if (access (buf, R_OK) == 0) names[i++] = strdup (buf); } names[i] = NULL; return &names[0]; } char * get_expander (file) char *file; { char *end = file + (strlen (file) - 1); while (end > file && end[-1] != '.') --end; if (end == file) return NULL; #ifdef FCAT if (*end == 'F') return FCAT; #endif /* FCAT */ #ifdef YCAT if (*end == 'Y') return YCAT; #endif /* YCAT */ #ifdef ZCAT if (*end == 'Z' || !strcmp(end, "gz")) return ZCAT; #endif /* ZCAT */ return NULL; } /* * Simply display the preformatted page. */ int display_cat_file (file) register char *file; { register int found; char command[FILENAME_MAX]; found = 0; if (access (file, R_OK) == 0) { char *expander = get_expander (file); if (expander != NULL) snprintf (command, sizeof(command), "%s %s | %s", expander, file, pager); else snprintf (command, sizeof(command), "%s %s", pager, file); found = do_system_command (command); } return found; } /* * Try to find the ultimate source file. If the first line of the * current file is not of the form * * .so man3/printf.3s * * the input file name is returned. */ char * ultimate_source (name, path) char *name; char *path; { static char buf[BUFSIZ]; static char ult[FILENAME_MAX]; FILE *fp; char *beg; char *end; strncpy (ult, name, sizeof(ult)-1); ult[sizeof(ult)-1] = '\0'; strncpy (buf, name, sizeof(buf)-1); ult[sizeof(buf)-1] = '\0'; next: if ((fp = fopen (ult, "r")) == NULL) return ult; end = fgets (buf, BUFSIZ, fp); fclose(fp); if (!end || strlen (buf) < 5) return ult; beg = buf; if (*beg++ == '.' && *beg++ == 's' && *beg++ == 'o') { while ((*beg == ' ' || *beg == '\t') && *beg != '\0') beg++; end = beg; while (*end != ' ' && *end != '\t' && *end != '\n' && *end != '\0') end++; *end = '\0'; snprintf(ult, sizeof(ult), "%s/%s", path, beg); snprintf(buf, sizeof(buf), "%s", ult); goto next; } if (debug) fprintf (stderr, "found ultimate source file %s\n", ult); return ult; } void add_directive (first, d, file, buf, bufsize) int *first; char *d; char *file; char *buf; int bufsize; { if (strcmp (d, "") != 0) { if (*first) { *first = 0; snprintf(buf, bufsize, "%s %s", d, file); } else { strncat (buf, " | ", bufsize-strlen(buf)-1); strncat (buf, d, bufsize-strlen(buf)-1); } } } int parse_roff_directive (cp, file, buf, bufsize) char *cp; char *file; char *buf; int bufsize; { char c; int first = 1; int tbl_found = 0; while ((c = *cp++) != '\0') { switch (c) { case 'e': if (debug) fprintf (stderr, "found eqn(1) directive\n"); if (troff) add_directive (&first, EQN, file, buf, bufsize); else add_directive (&first, NEQN, file, buf, bufsize); break; case 'g': if (debug) fprintf (stderr, "found grap(1) directive\n"); add_directive (&first, GRAP, file, buf, bufsize); break; case 'p': if (debug) fprintf (stderr, "found pic(1) directive\n"); add_directive (&first, PIC, file, buf, bufsize); break; case 't': if (debug) fprintf (stderr, "found tbl(1) directive\n"); tbl_found++; add_directive (&first, TBL, file, buf, bufsize); break; case 'v': if (debug) fprintf (stderr, "found vgrind(1) directive\n"); add_directive (&first, VGRIND, file, buf, bufsize); break; case 'r': if (debug) fprintf (stderr, "found refer(1) directive\n"); add_directive (&first, REFER, file, buf, bufsize); break; case ' ': case '\t': case '\n': goto done; default: return -1; } } done: if (first) return 1; #ifdef HAS_TROFF if (troff) { strncat (buf, " | ", bufsize-strlen(buf)-1); strncat (buf, TROFF, bufsize-strlen(buf)-1); } else #endif { strncat (buf, " | ", bufsize-strlen(buf)-1); strncat (buf, NROFF, bufsize-strlen(buf)-1); } if (tbl_found && !troff && strcmp (COL, "") != 0) { strncat (buf, " | ", bufsize-strlen(buf)-1); strncat (buf, COL, bufsize-strlen(buf)-1); } return 0; } char * make_roff_command (file) char *file; { FILE *fp; char line [BUFSIZ]; static char buf [BUFSIZ]; int status; char *cp; if (roff_directive != NULL) { if (debug) fprintf (stderr, "parsing directive from command line\n"); status = parse_roff_directive (roff_directive, file, buf, sizeof(buf)); if (status == 0) return buf; if (status == -1) gripe_roff_command_from_command_line (file); } if ((fp = fopen (file, "r")) != NULL) { cp = line; fgets (line, BUFSIZ, fp); fclose(fp); if (*cp++ == '\'' && *cp++ == '\\' && *cp++ == '"' && *cp++ == ' ') { if (debug) fprintf (stderr, "parsing directive from file\n"); status = parse_roff_directive (cp, file, buf, sizeof(buf)); if (status == 0) return buf; if (status == -1) gripe_roff_command_from_file (file); } } else { /* * Is there really any point in continuing to look for * preprocessor options if we can't even read the man page source? */ gripe_reading_man_file (file); return NULL; } if ((cp = getenv ("MANROFFSEQ")) != NULL) { if (debug) fprintf (stderr, "parsing directive from environment\n"); status = parse_roff_directive (cp, file, buf, sizeof(buf)); if (status == 0) return buf; if (status == -1) gripe_roff_command_from_env (); } if (debug) fprintf (stderr, "using default preprocessor sequence\n"); if ((cp = get_expander(file)) == NULL) cp = "/bin/cat"; snprintf(buf, sizeof(buf), "%s %s | ", cp, file); #ifdef HAS_TROFF if (troff) { if (strcmp (TBL, "") != 0) { strncat(buf, TBL, sizeof(buf)-strlen(buf)-1); strncat(buf, " | ", sizeof(buf)-strlen(buf)-1); strncat(buf, TROFF, sizeof(buf)-strlen(buf)-1); } else { strncat(buf, TROFF, sizeof(buf)-strlen(buf)-1); } } else #endif { if (strcmp (TBL, "") != 0) { strncat(buf, TBL, sizeof(buf)-strlen(buf)-1); strncat(buf, " | ", sizeof(buf)-strlen(buf)-1); strncat(buf, NROFF, sizeof(buf)-strlen(buf)-1); } else { strncpy (buf, NROFF, sizeof(buf)); } if (strcmp (COL, "") != 0) { strncat (buf, " | ", sizeof(buf)-strlen(buf)-1); strncat (buf, COL, sizeof(buf)-strlen(buf)-1); } } return buf; } sig_t ohup, oint, oquit, oterm; static char temp[FILENAME_MAX]; void cleantmp() { unlink(temp); exit(1); } void set_sigs() { ohup = signal(SIGHUP, cleantmp); oint = signal(SIGINT, cleantmp); oquit = signal(SIGQUIT, cleantmp); oterm = signal(SIGTERM, cleantmp); } void restore_sigs() { signal(SIGHUP, ohup); signal(SIGINT, oint); signal(SIGQUIT, oquit); signal(SIGTERM, oterm); } /* * Try to format the man page and create a new formatted file. Return * 1 for success and 0 for failure. */ int make_cat_file (path, man_file, cat_file, manid) register char *path; register char *man_file; register char *cat_file; { int s, f; FILE *fp, *pp; char *roff_command; char command[FILENAME_MAX]; roff_command = make_roff_command (man_file); if (roff_command == NULL) return 0; snprintf(temp, sizeof(temp), "%s.tmpXXXXXX", cat_file); if ((f = mkstemp(temp)) >= 0 && (fp = fdopen(f, "w")) != NULL) { set_sigs(); if (fchmod (f, CATMODE) < 0) { perror("fchmod"); unlink(temp); restore_sigs(); fclose(fp); return 0; } else if (debug) fprintf (stderr, "mode of %s is now %o\n", temp, CATMODE); #ifdef DO_COMPRESS snprintf (command, sizeof(command), "(cd %s ; %s | %s)", path, roff_command, COMPRESSOR); #else snprintf (command, sizeof(command), "(cd %s ; %s)", path, roff_command); #endif fprintf (stderr, "Formatting page, please wait..."); fflush(stderr); if (debug) fprintf (stderr, "\ntrying command: %s\n", command); else { #ifdef SETREUID if (manid) { setreuid(-1, ruid); setregid(-1, rgid); } #endif if ((pp = popen(command, "r")) == NULL) { s = errno; fprintf(stderr, "Failed.\n"); errno = s; perror("popen"); #ifdef SETREUID if (manid) { setreuid(-1, euid); setregid(-1, egid); } #endif unlink(temp); restore_sigs(); fclose(fp); return 0; } #ifdef SETREUID if (manid) { setreuid(-1, euid); setregid(-1, egid); } #endif f = 0; while ((s = getc(pp)) != EOF) { putc(s, fp); f++; } if (!f || ((s = pclose(pp)) == -1)) { s = errno; fprintf(stderr, "Failed.\n"); errno = s; perror("pclose"); unlink(temp); restore_sigs(); fclose(fp); return 0; } if (s != 0) { fprintf(stderr, "Failed.\n"); gripe_system_command(s); unlink(temp); restore_sigs(); fclose(fp); return 0; } } if (debug) unlink(temp); else if (rename(temp, cat_file) == -1) { s = errno; fprintf(stderr, "\nHmm! Can't seem to rename %s to %s, check permissions on man dir!\n", temp, cat_file); errno = s; perror("rename"); unlink(temp); restore_sigs(); fclose(fp); return 0; } restore_sigs(); if (fclose(fp)) { s = errno; if (!debug) unlink(cat_file); fprintf(stderr, "Failed.\n"); errno = s; perror("fclose"); return 0; } if (debug) { fprintf(stderr, "No output, debug mode.\n"); return 0; } fprintf(stderr, "Done.\n"); return 1; } else { if (f >= 0) { s = errno; unlink(temp); errno = s; } if (debug) { s = errno; fprintf (stderr, "Couldn't open %s for writing.\n", temp); errno = s; } if (f >= 0) { perror("fdopen"); close(f); } return 0; } } /* * Try to format the man page source and save it, then display it. If * that's not possible, try to format the man page source and display * it directly. * * Note that we've already been handed the name of the ultimate source * file at this point. */ int format_and_display (path, man_file, cat_file) register char *path; register char *man_file; register char *cat_file; { int status; register int found; char *roff_command; char command[FILENAME_MAX]; found = 0; if (access (man_file, R_OK) != 0) return 0; if (troff) { roff_command = make_roff_command (man_file); if (roff_command == NULL) return 0; else snprintf (command, sizeof(command), "(cd %s ; %s)", path, roff_command); found = do_system_command (command); } else { status = is_newer (man_file, cat_file); if (debug) fprintf (stderr, "status from is_newer() = %d\n", status); if (status == 1 || status == -2) { /* * Cat file is out of date. Try to format and save it. */ if (print_where) { printf ("%s\n", man_file); found++; } else { #ifdef SETREUID setreuid(-1, euid); setregid(-1, egid); found = make_cat_file (path, man_file, cat_file, 1); #else found = make_cat_file (path, man_file, cat_file, 0); #endif #ifdef SETREUID setreuid(-1, ruid); setregid(-1, rgid); if (!found) { /* Try again as real user - see note below. By running with effective group (user) ID == real group (user) ID except for the call above, I believe the problems of reading private man pages is avoided. */ found = make_cat_file (path, man_file, cat_file, 0); } #endif #ifdef SECURE_MAN_UID if (!found) { /* * Try again as real user. Note that for private * man pages, we won't even get this far unless the * effective user can read the real user's man page * source. Also, if we are trying to find all the * man pages, this will probably make it impossible * to make cat files in the system directories if * the real user's man directories are searched * first, because there's no way to undo this (is * there?). Yikes, am I missing something obvious? */ setuid (getuid ()); found = make_cat_file (path, man_file, cat_file, 0); } #endif if (found) { /* * Creating the cat file worked. Now just display it. */ (void) display_cat_file (cat_file); } else { /* * Couldn't create cat file. Just format it and * display it through the pager. */ roff_command = make_roff_command (man_file); if (roff_command == NULL) return 0; else snprintf (command, sizeof(command), "(cd %s ; %s | %s)", path, roff_command, pager); found = do_system_command (command); } } } else if (access (cat_file, R_OK) == 0) { /* * Formatting not necessary. Cat file is newer than source * file, or source file is not present but cat file is. */ if (print_where) { printf ("%s (source: %s)\n", cat_file, man_file); found++; } else { found = display_cat_file (cat_file); } } } return found; } /* * See if the preformatted man page or the source exists in the given * section. */ int try_section (path, section, name, glob) register char *path; register char *section; register char *name; register int glob; { register int found = 0; register int to_cat; register int cat; register char **names; register char **np; static int arch_search; char buf[FILENAME_MAX]; if (!arch_search) { snprintf(buf, sizeof(buf), "%s/man%s/%s", path, section, machine); if (is_directory (buf) == 1) { snprintf(buf, sizeof(buf), "%s/%s", machine, name); arch_search++; found = try_section (path, section, buf, glob); arch_search--; if (found && !findall) /* only do this architecture... */ return found; } } if (debug) { if (glob) fprintf (stderr, "trying section %s with globbing\n", section); else fprintf (stderr, "trying section %s without globbing\n", section); } #ifndef NROFF_MISSING /* * Look for man page source files. */ cat = 0; if (glob) names = glob_for_file (path, section, name, cat); else names = make_name (path, section, name, cat); if (names == (char **) -1 || *names == NULL) /* * No files match. See if there's a preformatted page around that * we can display. */ #endif /* NROFF_MISSING */ { if (!troff) { cat = 1; if (glob) names = glob_for_file (path, section, name, cat); else names = make_name (path, section, name, cat); if (names != (char **) -1 && *names != NULL) { for (np = names; *np != NULL; np++) { if (print_where) { printf ("%s\n", *np); found++; } else { found += display_cat_file (*np); } } } } } #ifndef NROFF_MISSING else { for (np = names; *np != NULL; np++) { register char *cat_file = NULL; register char *man_file; man_file = ultimate_source (*np, path); if (!troff) { to_cat = 1; cat_file = convert_name (man_file, to_cat); if (debug) fprintf (stderr, "will try to write %s if needed\n", cat_file); } found += format_and_display (path, man_file, cat_file); } } #endif /* NROFF_MISSING */ return found; } /* * Search for manual pages. * * If preformatted manual pages are supported, look for the formatted * file first, then the man page source file. If they both exist and * the man page source file is newer, or only the source file exists, * try to reformat it and write the results in the cat directory. If * it is not possible to write the cat file, simply format and display * the man file. * * If preformatted pages are not supported, or the troff option is * being used, only look for the man page source file. * */ int man (name) char *name; { register int found; register int glob; register char **mp; register char **sp; found = 0; fflush (stdout); if (section != NULL) { for (mp = manpathlist; *mp != NULL; mp++) { if (debug) fprintf (stderr, "\nsearching in %s\n", *mp); glob = 1; found += try_section (*mp, section, name, glob); if (found && !findall) /* i.e. only do this section... */ return found; } } else { for (sp = section_list; *sp != NULL; sp++) { for (mp = manpathlist; *mp != NULL; mp++) { if (debug) fprintf (stderr, "\nsearching in %s\n", *mp); glob = 1; found += try_section (*mp, *sp, name, glob); if (found && !findall) /* i.e. only do this section... */ return found; } } } return found; } char ** get_section_list () { int i; char *p; char *end; #define TMP_SECTION_LIST_SIZE 100 static char *tmp_section_list[TMP_SECTION_LIST_SIZE]; if (colon_sep_section_list == NULL) { if ((p = getenv ("MANSECT")) == NULL) { return std_sections; } else { colon_sep_section_list = strdup (p); } } i = 0; for (p = colon_sep_section_list; i < TMP_SECTION_LIST_SIZE ; p = end+1) { if ((end = strchr (p, ':')) != NULL) *end = '\0'; tmp_section_list[i++] = strdup (p); if (end == NULL) break; } tmp_section_list [i] = NULL; return tmp_section_list; } jp-man-1.1j/man/Makefile100644 5777 310 3271 7230555474 13707 0ustar tkumanoslt# $Id: Makefile,v 1.26 1999/07/05 02:46:20 hoek Exp $ # # Japanized by # Copyright (c) KUMANO, Tadashi , 1996-2001, # Copyright (c) FreeBSD jp-man project , 1996-1998, # which is a study toward the multilingual enhancement. # (version 1.1i 2001/01/15) PROG= jman SRCS= man.c manpath.c glob.c MAN1= jman.1 EMAN1= jman.1.eng.gz BINOWN= man BINMODE=4555 INSTALLFLAGS+= -fschg CFLAGS+= -I${LIBDESTDIR} DPADD= ${LIBMAN} LDADD= ${LIBMAN} .if exists(/usr/lib/libxpg4.a) LDADD+= -L/usr/lib -lxpg4 .endif DPADD+= ${MAN1} ${EMAN1} CFLAGS+= -I${.CURDIR}/../lib -DSTDC_HEADERS -DPOSIX -DHAS_TROFF CFLAGS+= -DDO_COMPRESS -DALT_SYSTEMS -DSETREUID -DCATMODE=0644 CFLAGS+= -DLOCALE CLEANFILES+= ${MAN1} ${EMAN1} ${EMAN1}${compext} MANDEPEND+= ${MAN1} .PATH: ${.CURDIR}/../manpath ${MAN1}: ${.CURDIR}/jman.man @${ECHO} echo Making ${.TARGET:T} from ${.ALLSRC:T}; \ sed -e 's,%libdir%,${libdir},' -e 's,%bindir%,${bindir},' \ -e 's,%pager%,${pager},' -e 's,%troff%,${troff},' \ -e 's,%manpath_config_file%,${manpath_config_file},' \ -e 's,%compress%,${compress},' \ ${.CURDIR}/jman.man > ${MAN1} ${EMAN1}: ${.CURDIR}/jman.man.eng @${ECHO} echo Making ${.TARGET:T} from ${.ALLSRC:T}; \ sed -e 's,%libdir%,${libdir},' -e 's,%bindir%,${bindir},' \ -e 's,%pager%,${pager},' -e 's,%troff%,${troff},' \ -e 's,%manpath_config_file%,${manpath_config_file},' \ -e 's,%compress%,${compress},' \ ${.CURDIR}/jman.man.eng | \ ${compress} > ${EMAN1} .if !defined(NOMAN) afterinstall: ${EMAN1} ${INSTALL} -c -o bin -g bin -m 444 ${EMAN1} \ ${DESTDIR}${EMANDIR}1/jman.1.gz .else afterinstall: .endif .include "../Makefile.inc" .include jp-man-1.1j/man/ndir.h100644 5777 310 2356 6437732773 13366 0ustar tkumanoslt/* -- definitions for 4.2BSD-compatible directory access last edit: 09-Jul-1983 D A Gwyn */ #ifdef VMS #ifndef FAB$C_BID #include #endif #ifndef NAM$C_BID #include #endif #ifndef RMS$_SUC #include #endif #include "dir.h" #endif /* VMS */ #define DIRBLKSIZ 512 /* size of directory block */ #ifdef VMS #define MAXNAMLEN (DIR$S_NAME + 7) /* 80 plus room for version #. */ #define MAXFULLSPEC NAM$C_MAXRSS /* Maximum full spec */ #else #define MAXNAMLEN 15 /* maximum filename length */ #endif /* VMS */ /* NOTE: MAXNAMLEN must be one less than a multiple of 4 */ struct direct /* data from readdir() */ { long d_ino; /* inode number of entry */ unsigned short d_reclen; /* length of this record */ unsigned short d_namlen; /* length of string in d_name */ char d_name[MAXNAMLEN+1]; /* name of file */ }; typedef struct { int dd_fd; /* file descriptor */ int dd_loc; /* offset in block */ int dd_size; /* amount of valid data */ char dd_buf[DIRBLKSIZ]; /* directory block */ } DIR; /* stream data from opendir() */ extern DIR *opendir(); extern struct direct *readdir(); extern long telldir(); extern void seekdir(); extern void closedir(); #define rewinddir( dirp ) seekdir( dirp, 0L ) jp-man-1.1j/man/jman.man.eng100644 5777 310 11753 7311134015 14445 0ustar tkumanoslt.\" Man page for man .\" .\" Copyright (c) 1990, 1991, John W. Eaton. .\" .\" You may distribute under the terms of the GNU General Public .\" License as specified in the README file that comes with the man 1.0 .\" distribution. .\" .\" John W. Eaton .\" jwe@che.utexas.edu .\" Department of Chemical Engineering .\" The University of Texas at Austin .\" Austin, Texas 78712 .\" .\" $FreeBSD: src/gnu/usr.bin/man/man/man.man,v 1.18 2001/04/17 12:49:38 ru Exp $ .\" .\" Japanized by .\" Copyright (c) KUMANO, Tadashi , 1996-2001, .\" which is a study toward the multilingual enhancement. .\" (version 1.1j 2001/06/11) .\" .Dd June 11, 2001 .Dt JMAN 1 .Os .Sh NAME .Nm jman .Nd format and display the on-line Japanese and/or original (English) manual pages .Sh SYNOPSIS .Nm jman .Op Fl adfhktow .Op Fl m Ar system .Op Fl p Ar string .Op Fl M Ar path .Op Fl P Ar pager .Op Fl S Ar list .Op Ar section .Ar name ... .Sh DESCRIPTION .Nm Jman formats and displays the on-line Japanese manual pages. This version knows about the .Ev MANPATH and .Ev PAGER environment variables, so you can have your own set(s) of personal man pages and choose whatever program you like to display the formatted pages. If section is specified, jman only looks in that section of the manual. You may also specify the order to search the sections for entries and which preprocessors to run on the source files via command line options or environment variables. If enabled by the system administrator, formatted man pages will also be compressed with the `%compress%' command to save space. You have to set the environment variable .Ev LC_CTYPE (or .Ev LANG ) to .Ev ja_JP.EUC if you prefer to consult Japanese manual pages. .Pp The options are as follows: .Bl -tag -width Fl .It Fl M Ar path Specify an alternate manpath. By default, jman uses .Nm jmanpath to determine the path to search. This option overrides the .Ev MANPATH environment variable. .It Fl P Ar pager Specify which pager to use. By default, jman uses .Nm %pager% , This option overrides the .Ev PAGER environment variable. .It Fl S Ar list List is a colon separated list of manual sections to search. This option overrides the .Ev MANSECT environment variable. .It Fl a By default, jman will exit after displaying the first manual page it finds. Using this option forces jman to display all the manual pages that match .Ar name , not just the first. .It Fl d Don't actually display the man pages, but do print gobs of debugging information. .It Fl f Equivalent to .Nm whatis . .It Fl h Print a one line help message and exit. .It Fl k Equivalent to .Nm apropos . .It Fl m Ar system Specify an alternate set of man pages to search based on the system name given. .It Fl o Restrain from searching and displaying non-original (non-English) man pages, regardless of the value of the environment variavble .Ev LC_CTYPE (or .Ev LANG ) . .It Fl p Ar string Specify the sequence of preprocessors to run before nroff or troff. Not all installations will have a full set of preprocessors. Some of the preprocessors and the letters used to designate them are: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). This option overrides the .Ev MANROFFSEQ environment variable. .It Fl t Use .Nm %troff% to format the manual page, passing the output to stdout. The output from .Nm %troff% may need to be passed through some filter or another before being printed. .It Fl w Don't actually display the man pages, but do print the location(s) of the files that would be formatted or displayed. .El .Sh ENVIRONMENT .Bl -tag -width MANROFFSEQ -compact .It Ev MANPATH If .Ev MANPATH is set, its value is used as the path to search for manual pages. .It Ev LC_CTYPE .It Ev LANG .Ev LC_CTYPE or .Ev LANG specify the language of the manual pages you prefer to consult. .It Ev MACHINE As some manual pages are intended only for specific architectures, .Nm searches any subdirectories, with the same name as the current architecture, in every directory which it searches. Machine specific areas are checked before general areas. The current machine type may be overridden by setting the environment variable .Ev MACHINE to the name of a specific architecture. .It Ev MANROFFSEQ If .Ev MANROFFSEQ is set, its value is used to determine the set of preprocessors run before running nroff or troff. By default, pages are passed through the table preprocessor before nroff. .It Ev MANSECT If .Ev MANSECT is set, its value is used to determine which manual sections to search. .It Ev PAGER If .Ev PAGER is set, its value is used as the name of the program to use to display the man page. By default, .Nm %pager% is used. .El .Sh EXAMPLES .Pp Normally, to look at the relevant manpage information for getopt, one would use: .Dl man getopt .Pp However, when referring to a specific section of the manual, such as .Xr getopt 3 , one would use: .Dl man 3 getopt .Sh SEE ALSO .Xr japropos 1 , .Xr jmanpath 1 , .Xr jwhatis 1 , .Xr jless 1 , .Xr groff 1 , .Xr man 7 , .Xr mdoc 7 .Sh BUGS The .Fl t option only works if a troff-like program is installed. jp-man-1.1j/man/jman.man100644 5777 310 12442 7312533241 13676 0ustar tkumanoslt.\" Man page for man .\" .\" Copyright (c) 1990, 1991, John W. Eaton. .\" .\" You may distribute under the terms of the GNU General Public .\" License as specified in the README file that comes with the man 1.0 .\" distribution. .\" .\" John W. Eaton .\" jwe@che.utexas.edu .\" Department of Chemical Engineering .\" The University of Texas at Austin .\" Austin, Texas 78712 .\" .\" $FreeBSD: src/gnu/usr.bin/man/man/man.man,v 1.18 2001/04/17 12:49:38 ru Exp $ .\" .\" Japanized by .\" Copyright (c) KUMANO, Tadashi , 1996-2001, .\" Copyright (c) FreeBSD jp-man project , 1996, 1998, .\" which is a study toward the multilingual enhancement. .\" (version 1.1j 2001/06/11) .\" .Dd June 11, 2001 .Dt JMAN 1 .Os .Sh 名称 .Nm jman .Nd 日本語マニュアルページを含めたオンラインマニュアルのフォーマット、表示を行なう .Sh 書式 .Nm jman .Op Fl adfhktow .Op Fl m Ar system .Op Fl p Ar string .Op Fl M Ar path .Op Fl P Ar pager .Op Fl S Ar list .Op Ar section .Ar name ... .Sh 解説 .Nm jman は日本語および英文オリジナルのマニュアルページをフォーマットし、表示します。 このバージョンでは、環境変数 .Ev MANPATH と .Ev PAGER を参照するので、各ユーザが固有のオンラインマニュアルを持つ事や、画面で見る際のページャを選ぶ事が可能です。 セクションを指定した場合、jman はそのセクションのみを探します。 また、コマンドラインオプションや環境変数によって、検索するセクションの順序や、ソースファイルを処理するプリプロセッサを指定することもできます。 システム管理者の設定によっては、ディスクスペースを節約するために、フォーマット済みのオンラインマニュアルを `%compress%' コマンドにより圧縮し格納するようにすることもできます。 ただし、日本語マニュアルページをオリジナルのマニュアルページに優先して表示するためにはあらかじめ環境変数 .Ev LC_CTYPE か .Ev LANG を .Ev ja_JP.EUC に設定しておく必要があります。 .Pp オプションは以下の通りです。 .Bl -tag -width Fl .It Fl M Ar path 別のマニュアルページを検索するパスを指定します。 通常、jman は .Nm jmanpath を使い、検索するパスを決めます。 このオプションは環境変数 .Ev MANPATH よりも優先されます。 .It Fl P Ar pager 使用するページャを指定します。 通常、jman は、 .Nm %pager% を使用します。 このオプションは環境変数 .Ev PAGER よりも優先されます。 .It Fl S Ar list list はコロンで区切られた検索するマニュアルのセクションのリストです。 このオプションは環境変数 .Ev MANSECT よりも優先されます。 .It Fl a 通常、jman は最初にみつかったマニュアルページを表示した後終了しますが、このオプションを使用すると、最初にみつかったマニュアルページだけでなく、 .Ar name , にマッチしたマニュアルページを全て表示します。 .It Fl d マニュアルページは表示せず、デバッグ用の情報を表示します。 .It Fl f .Nm whatis と同じです。 .It Fl h 一行のヘルプメッセージを表示して終了します。 .It Fl k .Nm apropos と同じです。 .It Fl m Ar system 与えられたシステム名をもとに検索する別のマニュアルセットを指定します。 このオプションは環境変数 .Ev SYSTEM よりも優先されます。 .It Fl o 環境変数 .Ev LC_CTYPE または .Ev LANG 設定にかかわらず、オリジナルのマニュアルページ以外の探索・表示を抑制します。 .It Fl p Ar string nroff や troff を行う前に実行するプリプロセッサの順序を指定します。 全てのプリプロセッサがインストールされているとはかぎりません。 プリプロセッサとそれを指定するのに使われる文字は以下の通りです。 eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). このオプションは環境変数 .Ev MANROFFSEQ よりも優先されます。 .It Fl t マニュアルページをフォーマットするのに .Nm %troff% を使い、stdout に出力します。 .Nm %troff% の出力は表示する前に何らかのフィルターを通す必要があるでしょう。 .It Fl w マニュアルページの表示は行わず、フォーマットや表示を行なうべきファイルの場所を表示します。 .El .Sh 環境変数 .Bl -tag -width MANROFFSEQ -compact .It Ev MANPATH .Ev MANPATH がセットされていれば、その値はマニュアルページを検索するパスとして使われます。 .It Ev LC_CTYPE .It Ev LANG オリジナルのマニュアルページに優先して検索するマニュアルページの言語を 決定します。 日本語マニュアルページを検索・表示するためには .Ev LC_CTYPE または .Ev LANG が .Ev ja_JP.EUC にセットされている必要があります。 .It Ev MACHINE 特定のアーキテクチャ向けのマニュアルページを提供するために、 .Nm jman は検索する各ディレクトリの下にある、現在のアーキテクチャ名と同じ名前のディレクトリ以下も検索します。 このアーキテクチャ依存マニュアルの置かれている場所は、アーキテクチャに依存しないマニュアルの置き場所より先に検索されます。 環境変数 .Ev MACHINE に特定のアーキテクチャ名がセットされている場合には、 現在のマシン種別よりこちらを優先します。 .It Ev MANROFFSEQ .Ev MANROFFSEQ がセットされていれば、その値は nroff や troff を行う前に実行されるプリプロセッサの順序を示すのに使われます。 デフォルトでは、nroff の前に tbl プリプロセッサが実行されます。 .It Ev MANSECT .Ev MANSECT がセットされていれば、その値はどのマニュアルセクションを検索するのかを決定するのに使われます。 .It Ev PAGER .Ev PAGER がセットされていれば、その値はマニュアルページを表示するのに使われるプログラムの名前を指定するのに使われます。 セットされていなければ、 .Nm %pager% が使われます。 .El .Sh 使用例 .Pp 通常、getopt に関連するマニュアルページの情報を見るためには、次のようにします。 .Dl man getopt .Pp 一方、特定のセクションのマニュアル、例えば .Xr getopt 3 を参照したいときには、以下のようにします。 .Dl man 3 getopt .Sh 関連項目 .Xr groff 1 , .Xr japropos 1 , .Xr jmanpath 1 , .Xr jwhatis 1 , .Xr jless 1 , .Xr man 7 , .Xr mdoc 7 .Sh バグ .Fl t オプションは troff ライクなプログラムがインストールされている場合のみ有効です。 jp-man-1.1j/manpath/ 40755 5777 310 0 7311141437 13012 5ustar tkumanosltjp-man-1.1j/manpath/Makefile100644 5777 310 1705 7311134276 14555 0ustar tkumanoslt# $FreeBSD: src/gnu/usr.bin/man/manpath/Makefile,v 1.23 2000/12/05 08:10:27 ru Exp $ PROG= jmanpath SRCS= manpath.c MAN1= jmanpath.1 EMAN1= jmanpath.1.eng.gz DPADD= ${LIBMAN} LDADD= ${LIBMAN} CFLAGS+= -DMAIN -DSTDC_HEADERS -DPOSIX -DHAS_TROFF -DDO_UNCOMPRESS CFLAGS+= -DALT_SYSTEMS -I${.CURDIR}/../lib -I${.OBJDIR}/../lib CLEANFILES+= ${MAN1} ${EMAN1} MANDEPEND+= ${MAN1} ${MAN1}: ${.CURDIR}/jmanpath.man @${ECHO} Making ${.TARGET:T} from ${.ALLSRC:T}; \ sed -e 's,%manpath_config_file%,${manpath_config_file},' \ ${.CURDIR}/jmanpath.man > ${MAN1} ${EMAN1}: ${.CURDIR}/jmanpath.man.eng @${ECHO} Making ${.TARGET:T} from ${.ALLSRC:T}; \ sed -e 's,%manpath_config_file%,${manpath_config_file},' \ ${.CURDIR}/jmanpath.man.eng | \ ${compress} > ${EMAN1} .if !defined(NOMAN) afterinstall: ${EMAN1} ${INSTALL} -c -o ${BINOWN} -g ${BINGRP} -m 444 ${EMAN1} \ ${DESTDIR}${EMANDIR}1/jmanpath.1.gz .endif .include "../Makefile.inc" .include jp-man-1.1j/manpath/manpath.c100644 5777 310 26043 7311141214 14721 0ustar tkumanoslt/* * manpath.c * * Copyright (c) 1990, 1991, John W. Eaton. * * You may distribute under the terms of the GNU General Public * License as specified in the file COPYING that comes with the man * distribution. * * John W. Eaton * jwe@che.utexas.edu * Department of Chemical Engineering * The University of Texas at Austin * Austin, Texas 78712 * * $FreeBSD: src/gnu/usr.bin/man/manpath/manpath.c,v 1.12 2001/02/13 16:55:42 ru Exp $ * * Japanized by * Copyright (c) KUMANO, Tadashi , 2001, * which is a study toward the multilingual enhancement. * (version 1.1j 2001/06/11) */ #define MANPATH_MAIN #include #include #include #include #include "config.h" #include "manpath.h" #include "gripes.h" #ifdef STDC_HEADERS #include #else extern int fprintf (); extern int strcmp (); extern int strncmp (); extern char *memcpy (); extern char *getenv(); extern char *malloc(); extern void free (); extern int exit (); #endif extern char *strdup (); extern int is_directory (); #ifndef MAIN extern int debug; #endif #ifdef MAIN #ifndef STDC_HEADERS extern char *strcpy (); extern int fflush (); #endif char *prognam; int debug; /* * Examine user's PATH and print a reasonable MANPATH. */ int main(argc, argv) int argc; char **argv; { int c; int quiet; char *mp; extern int getopt (); extern char *mkprogname (); void usage (); char *manpath (); quiet = 1; prognam = mkprogname (argv[0]); while ((c = getopt (argc, argv, "dhq?")) != EOF) { switch (c) { case 'd': debug++; break; case 'q': quiet = 0; break; case '?': case 'h': default: usage(); break; } } mp = manpath (quiet); fprintf (stdout, "%s\n", mp); fflush (stdout); return 0; } void usage () { fprintf (stderr, "usage: %s [-q]\n", prognam); exit (1); } #endif /* MAIN */ /* * If the environment variable MANPATH is set, return it. * If the environment variable PATH is set and has a nonzero length, * try to determine the corresponding manpath, otherwise, return the * default manpath. * * The manpath.config file is used to map system wide /bin directories * to top level man page directories. * * For directories which are in the user's path but not in the * manpath.config file, see if there is a subdirectory `man' or `MAN'. * If so, add that directory to the path. Example: user has * $HOME/bin in his path and the directory $HOME/bin/man exists -- the * directory $HOME/bin/man will be added to the manpath. * * Also search for a `man' directory next to the directory on the path. * Example: $HOME/bin will look for $HOME/man */ char * manpath (perrs) register int perrs; { register int len; register char *manpathlist; register char *path; int get_dirlist (); char *def_path (); char *get_manpath (); if (get_dirlist ()) gripe_reading_mp_config (config_file); if ((manpathlist = getenv ("MANPATH")) != NULL) /* * This must be it. */ { if (perrs) fprintf (stderr, "(Warning: MANPATH environment variable set)\n"); return strdup (manpathlist); } else if ((path = getenv ("PATH")) == NULL) /* * Things aren't going to work well, but hey... */ { if (perrs) fprintf (stderr, "Warning: path not set\n"); return def_path (perrs); } else { if ((len = strlen (path)) == 0) /* * Things aren't going to work well here either... */ { if (perrs) fprintf (stderr, "Warning: path set but has zero length\n"); return def_path (perrs); } return get_manpath (perrs, path); } } /* * Get the list of bin directories and the corresponding man * directories from the manpath.config file. * * This is ugly. */ int get_dirlist () { int i; char *bp; char *p; char buf[BUFSIZ]; DIRLIST *dlp = list; FILE *config; if ((config = fopen (config_file, "r")) == NULL) gripe_getting_mp_config (config_file); while ((bp = fgets (buf, BUFSIZ, config)) != NULL) { while (*bp && (*bp == ' ' || *bp == '\t')) bp++; if (*bp == '#' || *bp == '\n') continue; if (!strncmp ("MANDATORY_MANPATH", bp, 17) || !strncmp ("OPTIONAL_MANPATH", bp, 16)) { if ((p = strchr (bp, ' ')) == NULL && (p = strchr (bp, '\t')) == NULL) { fclose(config); return -1; } dlp->type = *bp == 'M'? MANPATH_MANDATORY: MANPATH_OPTIONAL; bp = p; while (*bp && *bp != '\n' && (*bp == ' ' || *bp == '\t')) bp++; i = 0; while (*bp && *bp != '\n' && *bp != ' ' && *bp != '\t') dlp->mandir[i++] = *bp++; dlp->mandir[i] = '\0'; if (debug) fprintf (stderr, "found %s man directory %s\n", dlp->type == MANPATH_MANDATORY? "mandatory": "optional", dlp->mandir); } else if (!strncmp ("MANPATH_MAP", bp, 11)) { if ((p = strchr (bp, ' ')) == NULL && (p = strchr (bp, '\t')) == NULL) { fclose(config); return -1; } bp = p; dlp->type = MANPATH_MAP; while (*bp && *bp != '\n' && (*bp == ' ' || *bp == '\t')) bp++; i = 0; while (*bp && *bp != '\n' && *bp != ' ' && *bp != '\t') dlp->bin[i++] = *bp++; dlp->bin[i] = '\0'; while (*bp && *bp != '\n' && (*bp == ' ' || *bp == '\t')) bp++; i = 0; while (*bp && *bp != '\n' && *bp != ' ' && *bp != '\t') dlp->mandir[i++] = *bp++; dlp->mandir[i] = '\0'; if (debug) fprintf (stderr, "found manpath map %s --> %s\n", dlp->bin, dlp->mandir); } else { gripe_reading_mp_config (config_file); } dlp++; } fclose(config); dlp->bin[0] = '\0'; dlp->mandir[0] = '\0'; dlp->type = MANPATH_NONE; return 0; } /* * Construct the default manpath. This picks up mandatory * and optional (if they exist) manpaths only. */ char * def_path (perrs) int perrs; { register int len; register char *manpathlist, *p; register DIRLIST *dlp; len = 0; dlp = list; while (dlp->type != MANPATH_NONE) { if (dlp->type == MANPATH_MANDATORY || dlp->type == MANPATH_OPTIONAL) len += strlen (dlp->mandir) + 1; dlp++; } manpathlist = (char *) malloc (len); if (manpathlist == NULL) gripe_alloc (len, "manpathlist"); *manpathlist = '\0'; dlp = list; p = manpathlist; while (dlp->type != MANPATH_NONE) { if (dlp->type == MANPATH_MANDATORY || dlp->type == MANPATH_OPTIONAL) { int status; char *path = dlp->mandir; status = is_directory(path); if (status < 0 && perrs && dlp->type == MANPATH_MANDATORY) { fprintf (stderr, "Warning: couldn't stat file %s!\n", path); } else if (status == 0 && perrs) { fprintf (stderr, "Warning: %s isn't a directory!\n", path); } else if (status == 1) { len = strlen (path); memcpy (p, path, len); p += len; *p++ = ':'; } } dlp++; } p[-1] = '\0'; return manpathlist; } /* * For each directory in the user's path, see if it is one of the * directories listed in the manpath.config file. If so, and it is * not already in the manpath, add it. If the directory is not listed * in the manpath.config file, see if there is a subdirectory `man' or * `MAN'. If so, and it is not already in the manpath, add it. * Example: user has $HOME/bin in his path and the directory * $HOME/bin/man exists -- the directory $HOME/bin/man will be added * to the manpath. */ char * get_manpath (perrs, path) register int perrs; register char *path; { register int len; register char *tmppath; register char *t; register char *p; register char **lp; register char *end; register char *manpathlist; register DIRLIST *dlp; void add_dir_to_list (); char *has_subdirs (); tmppath = strdup (path); for (p = tmppath; ; p = end+1) { if ((end = strchr(p, ':')) != NULL) *end = '\0'; if (debug) fprintf (stderr, "\npath directory %s ", p); if (*p != '/') { if (debug) fprintf (stderr, "is not an absolute pathname\n"); goto found; /* skip. */ } /* * The directory we're working on is in the config file. * If we haven't added it to the list yet, do. */ for (dlp = list; dlp->mandir[0] != '\0'; dlp++) if (dlp->bin[0] != '\0' && !strcmp (p, dlp->bin)) { if (debug) fprintf (stderr, "is in the config file\n"); add_dir_to_list (tmplist, dlp->mandir, perrs); goto found; } /* * The directory we're working on isn't in the config file. See * if it has man or MAN subdirectories. If so, and it hasn't * been added to the list, do. */ if (debug) fprintf (stderr, "is not in the config file\n"); t = has_subdirs (p); if (t != NULL) { if (debug) fprintf (stderr, "but it does have a man or MAN subdirectory\n"); add_dir_to_list (tmplist, t, perrs); free (t); } else { if (debug) fprintf (stderr, "and doesn't have man or MAN subdirectories\n"); } found: if (!end) break; } if (debug) fprintf (stderr, "\nadding mandatory man directories\n\n"); dlp = list; while (dlp->type != MANPATH_NONE) { if (dlp->type == MANPATH_MANDATORY || dlp->type == MANPATH_OPTIONAL) add_dir_to_list (tmplist, dlp->mandir, dlp->type == MANPATH_MANDATORY? perrs: 0); dlp++; } len = 0; lp = tmplist; while (*lp != NULL) { len += strlen (*lp) + 1; lp++; } manpathlist = (char *) malloc (len); if (manpathlist == NULL) gripe_alloc (len, "manpathlist"); *manpathlist = '\0'; lp = tmplist; p = manpathlist; while (*lp != NULL) { len = strlen (*lp); memcpy (p, *lp, len); p += len; *p++ = ':'; lp++; } p[-1] = '\0'; return manpathlist; } /* * Add a directory to the manpath list if it isn't already there. */ void add_dir_to_list (lp, dir, perrs) char **lp; char *dir; int perrs; { extern char *strdup (); int status; while (*lp != NULL) { if (!strcmp (*lp, dir)) { if (debug) fprintf (stderr, "%s is already in the manpath\n", dir); return; } lp++; } /* * Not found -- add it. */ status = is_directory(dir); if (status < 0 && perrs) { fprintf (stderr, "Warning: couldn't stat file %s!\n", dir); } else if (status == 0 && perrs) { fprintf (stderr, "Warning: %s isn't a directory!\n", dir); } else if (status == 1) { if (debug) fprintf (stderr, "adding %s to manpath\n", dir); *lp = strdup (dir); } } /* * Check to see if the current directory has man or MAN * subdirectories. */ char * has_subdirs (p) register char *p; { int len; register char *t; len = strlen (p); t = (char *) malloc ((unsigned) len + 5); if (t == NULL) gripe_alloc (len+5, "p\n"); memcpy (t, p, len); strcpy (t + len, "/man"); if (is_directory (t) == 1) return t; strcpy (t + len, "/MAN"); if (is_directory (t) == 1) return t; /* If the path ends in `bin' then replace with `man' and see if that works. */ if (len > 3 && strncmp(t+len-4, "/bin", 4) == 0) { strcpy(t+len-4, "/man"); if (is_directory(t) == 1) return t; } return NULL; } jp-man-1.1j/manpath/manpath.config100644 5777 310 1466 6764303721 15744 0ustar tkumanoslt# $Id: manpath.config,v 1.13 1999/08/20 10:44:51 ru Exp $ # # This file is read by manpath(1) to configure the mandatory manpath, # optional manpath and to map each path element to a manpath element. # The format is: # # MANDATORY_MANPATH manpath_element # OPTIONAL_MANPATH manpath_element # MANPATH_MAP path_element manpath_element # # every automatically generated MANPATH includes these fields # MANDATORY_MANPATH /usr/share/man MANDATORY_MANPATH /usr/share/perl/man MANDATORY_MANPATH /usr/X11R6/man # # check if the directory exists and if it does, add it to MANPATH # OPTIONAL_MANPATH /usr/local/lib/perl5/5.00503/man # # set up PATH to MANPATH mapping # MANPATH_MAP /bin /usr/share/man MANPATH_MAP /usr/bin /usr/share/man MANPATH_MAP /usr/local/bin /usr/local/man MANPATH_MAP /usr/X11R6/bin /usr/X11R6/man jp-man-1.1j/manpath/manpath.h100644 5777 310 1303 6764304113 14710 0ustar tkumanoslt/* * manpath.h * * Copyright (c) 1990, 1991, John W. Eaton. * * You may distribute under the terms of the GNU General Public * License as specified in the file COPYING that comes with the man * distribution. * * John W. Eaton * jwe@che.utexas.edu * Department of Chemical Engineering * The University of Texas at Austin * Austin, Texas 78712 */ typedef struct { char mandir[MAXPATHLEN]; char bin[MAXPATHLEN]; int type; } DIRLIST; /* manpath types */ #define MANPATH_NONE 0 #define MANPATH_MANDATORY 1 /* manpath is mandatory */ #define MANPATH_OPTIONAL 2 /* manpath is optional */ #define MANPATH_MAP 3 /* maps path to manpath */ DIRLIST list[MAXDIRS]; char *tmplist[MAXDIRS]; jp-man-1.1j/manpath/jmanpath.man.eng100644 5777 310 3606 7311134141 16155 0ustar tkumanoslt.\" Man page for manpath .\" .\" Copyright (c) 1990, 1991, John W. Eaton. .\" .\" You may distribute under the terms of the GNU General Public .\" License as specified in the README file that comes with the man 1.0 .\" distribution. .\" .\" John W. Eaton .\" jwe@che.utexas.edu .\" Department of Chemical Engineering .\" The University of Texas at Austin .\" Austin, Texas 78712 .\" .\" $FreeBSD: src/gnu/usr.bin/man/manpath/manpath.man,v 1.7 2000/12/11 15:10:53 ru Exp $ .\" .\" Japanized by .\" Copyright (c) KUMANO, Tadashi , 1996-2001 .\" Copyright (c) FreeBSD jp-man project , 1996, .\" which is a study toward the multilingual enhancement. .\" (version 1.1j 2001/06/11) .\" .Dd June 11, 2001 .Dt JMANPATH 1 .Os .Sh NAME .Nm jmanpath .Nd determine user's search path for Japanese man pages .Sh SYNOPSIS .Nm .Op Fl q .Sh DESCRIPTION .Nm Jmanpath tries to determine the user's Japanese manpath from a set of system defaults and the user's .Ev PATH , echoing the result to the standard output. Warnings and errors are written to the standard error. If a directory in the user's path is not listed in the .Pa %manpath_config_file% file, .Nm looks for the subdirectories .Pa man or .Pa MAN . If they exist, they are added to the search path. .Pp .Nm Jmanpath is used by .Xr jman 1 to determine the search path, so user normally don't need to set the .Ev MANPATH environment variable directly. .Pp The options are as follows: .Bl -tag -width Fl .It Fl q Operate quietly. Only echo the final manpath. .El .Sh ENVIRONMENT .Bl -tag -width MANPATH -compact .It Ev MANPATH If .Ev MANPATH is set, .Nm echoes its value on the standard output and issues a warning on the standard error. .El .Sh FILES .Bl -tag -width %manpath_config_file% -compact .It Pa %manpath_config_file% System configuration file. .El .Sh SEE ALSO .Xr japropos 1 , .Xr jman 1 , .Xr jwhatis 1 .Sh BUGS None known. jp-man-1.1j/manpath/jmanpath.man100644 5777 310 3526 7311134174 15414 0ustar tkumanoslt.\" Man page for manpath .\" .\" Copyright (c) 1990, 1991, John W. Eaton. .\" .\" You may distribute under the terms of the GNU General Public .\" License as specified in the README file that comes with the man 1.0 .\" distribution. .\" .\" John W. Eaton .\" jwe@che.utexas.edu .\" Department of Chemical Engineering .\" The University of Texas at Austin .\" Austin, Texas 78712 .\" .\" $FreeBSD: src/gnu/usr.bin/man/manpath/manpath.man,v 1.7 2000/12/11 15:10:53 ru Exp $ .\" .\" Japanized by .\" Copyright (c) KUMANO, Tadashi , 1996-2001 .\" Copyright (c) FreeBSD jp-man project , 1996 .\" which is a study toward the multilingual enhancement. .\" (version 1.1j 2001/06/11) .\" .Dd June 11, 2001 .Dt JMANPATH 1 .Os .Sh 名称 .Nm jmanpath .Nd 日本語マニュアルページのユーザのサーチパスを決める .Sh 書式 .Nm .Op Fl q .Sh 解説 .Nm jmanpath はシステム標準およびユーザの .Ev PATH からユーザの日本語マニュアルページのサーチパスを決め、結果を標準出力へ表示します。 また警告およびエラーは標準エラー出力へ出力します。 ユーザのパスが .Pa %manpath_config_file% ファイルに無いときは .Nm は .Pa man または .Pa MAN という名前のサブディレクトリを検索し、見付かればそれを検索パスに追加します。 .Pp .Nm は .Xr jman 1 が検索パスを決めるのにも使用します。 したがって、普通は環境変数 .Ev MANPATH を直接設定する必要はありません。 .Pp オプションは以下の通りです。 .Bl -tag -width Fl .It Fl q 「静かに」実行します。最終的なマニュアルページ検索パスだけを表示します。 .El .Sh 環境変数 .Bl -tag -width MANPATH -compact .It Ev MANPATH .Ev MANPATH を設定すると .Nm はその設定を標準出力に表示し、標準エラー出力に警告を出力します。 .El .Sh ファイル .Bl -tag -width %manpath_config_file% -compact .It Pa %manpath_config_file% システムコンフィギュレーションファイル。 .El .Sh 関連項目 .Xr japropos 1 , .Xr jman 1 , .Xr jwhatis 1 .Sh バグ 既知のバグはありません。