Automatic conversion of the NetBSD pkgsrc CVS module, use with care
f774d18767
User-visible changes between 0.4.0 and 0.5.0: Changes in behaviour: There are now two engines: the fast engine (gforth-fast) is at least as fast as gforth in earlier releases; the debugging engine (gforth) supports precise backtracing for signals (e.g., illegal memory access), but is slower by a factor of 1-2. Block files now start at block 0 by default (instead of block 1). If you have block files around, prepend 1024 bytes to convert them, or do a "1 OFFSET !" to establish the old behaviour. Gforth now does not translate newlines to LFs on reading. Instead, READ-LINE now interprets LF, CR, and CRLF as newlines. Newlines on output are in the OSs favourite format. SEE now disassembles primitives (or hex-DUMPs the code if no disassembler is available). >HEAD (aka >NAME) now returns 0 (instead of the nt of ???) on failure. Syntax of prim changed: stack effects are now surrounded by parentheses, tabs are insignificant. Operating environment: Gforth now produces a backtrace when catching an exception. On platforms supporting the Unix 98 SA_SIGINFO semantics, you get more precise error reports for SIGSEGV and SIGFPE (e.g., "stack underflow" instead of "Invalid memory address"). Gforth now produces exit code 1 if there is an error (i.e., an uncaught THROW) in batch processing. You can use "gforthmi --application ..." to build an image that processes the whole command-line when invoked directly (instead of through gforth -i). Ports: AIX. 20% speedup on 604e under powerpc-unknown-linux-gnu, 19%-29% speedup on Celeron with gcc-2.95. New words: Missing ANS Forth words: EKEY EKEY? EKEY>CHAR Timing words: CPUTIME UTIME Vector arithmetic: V* FAXPY FP comparison: F~ABS F~REL Deferred words: <IS> [IS] Nested number output: <<# #>> Exception handling: TRY RECOVER ENDTRY Directory handling: OPEN-DIR READ-DIR CLOSE-DIR FILENAME-MATCH Other: ]L PUSH-ORDER Miscellaneous: Significant extensions to the manual (added an introduction, among other things), many of them due to a new team member: Neal Crook. Added assemblers and disassemblers for 386, Alpha, MIPS (thanks to contributions by Andrew McKewan, Bernd Thallner, and Christian Pirker). Contributions of assemblers and disassemblers for other architectures are welcome. |
||
|---|---|---|
| archivers | ||
| audio | ||
| benchmarks | ||
| biology | ||
| cad | ||
| comms | ||
| converters | ||
| cross | ||
| databases | ||
| devel | ||
| distfiles | ||
| editors | ||
| emulators | ||
| fonts | ||
| games | ||
| graphics | ||
| ham | ||
| japanese | ||
| lang | ||
| math | ||
| mbone | ||
| meta-pkgs | ||
| misc | ||
| mk | ||
| net | ||
| news | ||
| packages | ||
| parallel | ||
| pkgtools | ||
| plan9 | ||
| security | ||
| shells | ||
| sysutils | ||
| templates | ||
| textproc | ||
| www | ||
| x11 | ||
| Makefile | ||
| Packages.txt | ||
| pkglocate | ||
| README | ||
$NetBSD: README,v 1.11 2000/07/23 18:02:33 fredb Exp $ Welcome to the NetBSD Packages Collection ========================================= In brief, the NetBSD Packages Collection is a set of software utilities and libraries which have been ported to NetBSD. The packages collection software can retrieve the software from its home site, assuming you are connected in some way to the Internet, verify its integrity, apply any patches, configure the software for NetBSD, and build it. Any prerequisite software will also be built and installed for you. Installation and de-installation of software is managed by the packaging utilities. The packages collection is made into a tar_file every week: ftp://ftp.netbsd.org/pub/NetBSD/NetBSD-current/tar_files/pkgsrc.tar.gz and you can sup the pkgsrc tree using the `pkgsrc' name for the collection. The pkgsrc tree is laid out in various categories, and, within that, the various packages themselves. You need to have root privileges to install packages. We are looking at ways to remove this restriction. + To install a package on your system, you need to change into the directory of the package, and type "make install". + If you've made a mistake, and decided that you don't want that package on your system, then type "pkg_delete <pkg-name>", or "make deinstall" while in the directory for the package. + To find out all the packages that you have installed on your system, type "pkg_info". + To remove the work directory, type "make clean", and "make clean-depends" will clean up any working directories for other packages that are built in the process of making your package. + Optionally, you can periodically run "make clean" from the top level pkgsrc directory. This will delete extracted and built files, but will not affect the retreived source sets in pkgsrc/distfiles. + You can set variables to customise the behaviour (where packages are installed, various options for individual packages etc), by setting variables in /etc/mk.conf. The pkgsrc/mk/mk.conf.example file provides some examples for customisation. The best way to find out what packages are in the collection is to move to the top-level pkgsrc directory (this will usually be /usr/pkgsrc), and type "make readme". This will create a file called README.html in the top-level pkgsrc directory, and also in all category and package directories. You can then see what packages are available, along with a short (one-line) comment about the function of the package, and a pointer to a fuller description, by using a browser like lynx (see pkgsrc/www/lynx) or Mozilla (pkgsrc/www/mozilla), or Communicator. This is also available online as ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/README.html. Another way to find out what packages are in the collection is to move to the top-level pkgsrc directory and type "make index". This will create pkgsrc/INDEX which can be viewed via "make print-index | more". You can also search for particular packages or keywords via "make search key=<somekeyword>". It is also possible to use the packaging software to install pre-compiled binary packages by typing "pkg_add <URL-of-binary-pkg>". To see what binary packages are available, see: ftp://ftp.netbsd.org/pub/NetBSD/packages/<release>/<arch>/All/ where <release> is the NetBSD release, and <arch> is the hardware architecture. One limitation of using binary packages provided from ftp.netbsd.org is that all mk.conf options were set to the defaults at compile time. LOCALBASE, in particular, defaults to /usr/pkg, so non-X binaries will be installed in /usr/pkg/bin, man pages will be installed in /usr/pkg/man... When a packaged tool has major compile time choices, such as support for multiple graphic toolkit libraries, the different options may be available as separate packages. For more information on the packages collection see the file Packages.txt where you found this README, or in your top-level pkgsrc directory.