ext2fs: nls: Update to unicode 12.1.0

[thirdparty/e2fsprogs.git] / INSTALL

diff --git a/INSTALL b/INSTALL
index b053c6c854088d267c7c9cf9a0339b4dcfffa8fd..2dd08f53bdae7c29b6c360125c51591383d907ba 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -1,34 +1,69 @@
-       To install the second extended file system management program,
+       To install the second extended file system management programs,
 just follow the steps:
 
-1) Edit the file MCONFIG
+1) Change directory into the top of the e2fsprogs source tree
 
-       This file contains definitions used in the various makefiles.  These
-definitions have reasonable default value but you may want to adjust them to 
-your system configuration.
+2) Create a build directory and cd into it:
 
-2) Create the dependencies files
+       mkdir build; cd build
 
-       Run `make depend' to create the dependencies files.  Note that this
-is not strictly necessary since the makefiles automagically recreates them
-if they do not exist.
+3)  Run the configure script
 
-3) Compile the programs
+       ../configure
 
-       Run `make' to compile the libraries and the programs.
+       If you wish to turn on ELF shared libraries, add the option
+--enable-elf-shlibs.  If you wish to build profiling libraries, add
+the option --enable-profile.
 
-4) Install the programs
+       Note that if you are building on an older system (i.e., a 2.4
+kernel and/or glibc 2.2), the use of thread local storage will probably
+cause programs that use the uuid library to core dump.  To disable
+thread local storage, use the configure option --disable-tls.
+
+4)  Compile the programs
+
+       make
+
+5)   Check to make sure the installation built correctly:
+
+       make check
+
+6)  Install the programs
 
        Run `make install'
 
-5) Install the include files and libraries
+7)  Install the include files and libraries
 
        You can run `make install-libs' to install the include files and
 libraries.  Please note that this installation is not needed for the
 programs to work.  It is only needed if you expect to develop other
-programs using the libraries.
+programs using the libraries or if you want to compile other program
+using these libraries (like the 4.4BSD dump and restore port).
+
+8)  Remove any pre-formatted man pages.  
+
+       Some distributions will have pre-formatted manual pages which
+will always be displayed in preference to newer man pages in /usr/man.
+If this is the case, you may need to manually remove them in order to
+see the correct manual pages.  The shell script in
+install-utils/remove_preformat_manpages may be helpful in doing so.
+
+9)  Make sure your /etc/fstab file is correct.
+
+       Some distributions install an /etc/fstab which is missing the
+fifth and sixth field of filesystem entry, which are the dump
+frequency, and the fsck pass number, respectively.  The problem with
+this is that the getmntent() library routine interprets those missing
+fields as "0", and a pass number of 0 is documented as meaning that
+fsck should not check that particular filesystem.  If your entries in
+your /etc/fstab file look like this:
+
+/dev/hda4       /        ext2        defaults
+
+you should add "1 1" at the end of each line, so that they look like this:
+
+/dev/hda4       /        ext2        defaults  1       1
 
+       There is a script in install-utils/convfstab (donated by
+Michael Weller) that may help you correct your /etc/fstab file.
 
-       You can run `make world' as an alternative to steps 2 and 3.  This
-will create the dependencies files, compile the programs and run e2fsck on
-a test suite contained in e2fsck/images.