summaryrefslogtreecommitdiff
path: root/INSTALL.txt
diff options
context:
space:
mode:
Diffstat (limited to 'INSTALL.txt')
-rw-r--r--INSTALL.txt76
1 files changed, 55 insertions, 21 deletions
diff --git a/INSTALL.txt b/INSTALL.txt
index d70dcd0..ae9d46e 100644
--- a/INSTALL.txt
+++ b/INSTALL.txt
@@ -17,12 +17,14 @@ PREREQUISITES
* groff : GNU troff text formatting system.
* ghostscript : An interpreter for the PostScript language and
for PDF (ps2pdf)
+ * iconv : Character set conversion utility.
- Alternative for Windows/DOS:
- * Open Watcom : http://www.openwatcom.org/
- Required for DOS16 bit:
- * Open Watcom : http://www.openwatcom.org/
+ Using Watcom C:
+ Required
+ * Open Watcom : http://www.openwatcom.org/
+ * perl : Practical Extraction and Report Language (perlpod)
+
BASIC INSTALLATION
@@ -47,8 +49,9 @@ BASIC INSTALLATION
make clean
- Mostly clean. The target mostlyclean will preserve the generated
- documentation files.
+ Mostly clean.
+
+ The target mostlyclean will preserve the generated documentation files.
make mostlyclean
@@ -64,6 +67,7 @@ INSTALLATION NAMES
make prefix=$HOME clean all
make prefix=$HOME install
+
DEBUG
A debug enabled build can be made by adding DEBUG=1
@@ -74,6 +78,7 @@ DEBUG
With debug enabled dos2unix will print extra information
and you can debug the source code in gdb.
+
NATIVE LANGUAGE SUPPORT
Native Language Support (NLS) is by default enabled.
@@ -81,6 +86,7 @@ NATIVE LANGUAGE SUPPORT
make clean install ENABLE_NLS=
+
LARGE FILE SUPPORT
Large File Support (LFS) is by default enabled. This enables
@@ -92,6 +98,7 @@ LARGE FILE SUPPORT
Disable LFS:
make clean install LFS=
+
UNICODE SUPPORT
Unicode UTF-16 support is by default enabled for Windows and Unix. To
@@ -100,28 +107,45 @@ UNICODE SUPPORT
Disable Unicode:
make clean install UCS=
- Unicode UTF-16 is not supported by the DOS versions.
+ Unicode UTF-16 is not supported by the DOS and OS/2 versions.
ESPERANTO X-NOTATION
For systems that don't support the Unicode or Latin-3 character set,
Esperanto messages in ASCII x-notation format can be selected. Add
- EO_XNOTATION=1 tot the make command-line. It will change the format of the
+ EO_XNOTATION=1 to the make command-line. It will change the format of the
normal dos2unix 'eo' locale from Unicode to ASCII x-notation.
make clean install EO_XNOTATION=1
+
DOCUMENTATION
- Manual pages are generated from Perl POD files. By default
- the manual pages are are created in text and html format.
- To create a manual in PDF format type:
+ Manual pages are generated from Perl POD files.
+
+ The manual pages in text and html format are by default only
+ created in English language. To create text and html manuals
+ for other languages type:
+
+ make txt
+ make html
+
+ Once the manuals in non-English languages have been created,
+ they will also be installed under share/doc/ when you type
+ 'make install'
+
+ Creation of non-English manuals in text or html format require
+ an installation of iconv.
+
+ Manuals in PDF format are by default not created.
+ To create manuals in PDF format type:
make pdf
PDF generation requires GhostScript to be installed.
+
WINDOWS PORT
To compile a version for Windows, get the Mingw compiler
@@ -132,11 +156,11 @@ WINDOWS PORT
make -f mingw.mak strip
make -f mingw.mak install
- Or get the Open Watcom C compiler <http://www.openwatcom.org>
- and type:
+ Or use Open Watcom and type:
wmake -f wccwin32.mak clean
wmake -f wccwin32.mak
+ wmake -f wccwin32.mak install
The win32 binaries built with MinGW32 are packed with a patched version of
@@ -155,6 +179,7 @@ WINDOWS 64 BIT PORT
make -f mingw64.mak strip
make -f mingw64.mak install
+
DOS PORT, 32 BIT
To compile a version for DOS, get the DJGPP compiler
@@ -165,10 +190,12 @@ DOS PORT, 32 BIT
make -f djgpp.mak strip
make -f djgpp.mak install
- Or use the OpenWatcom compiler <http://www.openwatcom.org>.
+ Or use Open Watcom
wmake -f wccdos32.mak clean
wmake -f wccdos32.mak
+ wmake -f wccdos32.mak install
+
DOS PORT, 16 BIT
@@ -178,18 +205,25 @@ DOS PORT, 16 BIT
make -f bcc.mak clean
make -f bcc.mak
- Or use the OpenWatcom compiler <http://www.openwatcom.org>.
+ Or use Open Watcom
wmake -f wccdos16.mak clean
wmake -f wccdos16.mak
+ wmake -f wccdos16.mak install
+
OS/2 PORT
- Using Paul Smedley's build environment, available
- at <http://os2ports.smedley.info>
+ Using EMX
+
+ make -f emx.mak clean
+ make -f emx.mak
+ make -f emx.mak strip
+ make -f emx.mak install
+
+ Open Watcom
- make -f os2.mak clean
- make -f os2.mak
- make -f os2.mak strip
- make -f os2.mak install
+ wmake -f wccos2.mak clean
+ wmake -f wccos2.mak
+ wmake -f wccos2.mak install