aboutsummaryrefslogblamecommitdiffstats
path: root/INSTALL
blob: c267f744e32e16188fd5c66c651c98a44ca279a7 (plain) (tree)
1
2
3
4
5
6
7
8
9
10

                                                                              
 

                                                               
 



                                                                           
 












                                                                           
        
                         


                                                                    
                          


                                                                             




                                                                                                                                                                                                                                                
                                                 
 
                              
 

                                                     
 
                                  
 




                                                                                                                                                                                                                                                


                                                                       
 
                                     
 
 


                                                                                                                                                                                                                                                
 

                                                     
 

                                             
 
                                       
 

                                       








                                                                                                                                                                                                                                                      
                                                                                          





                                                                                          
                                                                                          






                                                                                                                                                                                                                                                      



                                                                             
Type './configure --help' for configuration options. The normal settings for a
GNU package should work. If not, please make a bug report.

	On a common GNU/Linux distribution the following should
	be sufficient for most users:

		./configure --prefix=/usr
		make
		make install DESTDIR="somewhere you want the files for now"
		# Now let the package manager put the files in place...

	Or for an unstaged install:

		./configure --prefix=/usr
		make
		sudo make install

By default any applicable pre-install, post-install, pre-uninstall, and
post-install commands is run. This suppress these, run 'make' with 'N=true'
or 'N=:'. IF you want to know which these commands are, you can use the
methods specificed in the GNU Coding Standards. Another method is found in
mk/README. However, for this packages, these will be:

	infodir="usr/local/share/info" ## Assuming default prefix.
	
	post_install () {
	  install-info -- "${infodir}/scrotty.info" "${infodir}/dir"
	}
	
	pre_uninstall () {
	  install-info --delete -- "${infodir}/scrotty.info" "${infodir}/dir"
	}


────────────────────────────────────────────────────────────────────────────────
INTERNATIONALISATION
────────────────────────────────────────────────────────────────────────────────

You can chose to restrict the locales to install:

	./configure LOCALES=sv

You can select which translations of the man page you
want to install too:

	./configure MAN_LOCALES=sv


────────────────────────────────────────────────────────────────────────────────
CUSTOMISED COMPILATION
────────────────────────────────────────────────────────────────────────────────

The makefile is configured to compile the C code with -O2 -g, you can
change this by setting OPTIMISE, or with CFLAGS and LDFLAGS if you want
to change all optional flags compiling and linking flags:

	./configure OPTIMISE="-Og -g"


────────────────────────────────────────────────────────────────────────────────
CUSTOMISED INSTALLATION
────────────────────────────────────────────────────────────────────────────────

If you want to install absolutely everything, you can
instead use the commands below:

	make everything
	make install-everything DESTDIR="pkg"

Or if you only want to absolute basics:

	make base
	make install-base DESTDIR="pkg"

You can select freely what parts of the package to install and not
to install. This rules are available:

┌─────────────┬─────────────────────┬────────────────────────────────────────────┐
│ COMPILATION │ INSTALLATION        │ DESCRIPTION                                │
├─────────────┼─────────────────────┼────────────────────────────────────────────┤
│ base        │ install-base        │ Install be basics:                         │
│   cmd       │   install-cmd       │   Install the scrotty command.             │
│             │   install-copyright │   Install GNU GPL version 3.               │
│ doc         │ install-doc         │ Include all manuals:                       │
│   info      │   install-info      │   Include info manual. (Texinfo)           │
│   dvi       │   install-dvi       │   Include DVI manual. (Texinfo)            │
│   pdf       │   install-pdf       │   Include PDF manual. (Texinfo)            │
│   ps        │   install-ps        │   Include PostScript manual. (Texinfo)     │
│   html      │   install-html      │   Include multifile HTML manual. (Texinfo) │
│             │   install-man       │   Include man pages.                       │
│ locale      │ install-locale      │ Include locales.                           │
└─────────────┴─────────────────────┴────────────────────────────────────────────┘

install, install-everything, install-base, and install-cmd, have alternatives
that installs a stripped binary: install-strip, install-everything-strip,
install-base-strip, and install-cmd-strip, respectively.

The untranslated man page is installed via the rule install-man-untranslated.
Additional translations are installed via the rule install-man-locale, which
installes the locales listed in MAN_LOCALES.