Singular distributes a version of the Normaliz interface. To use it just start
Singular and do
    LIB "normaliz.lib";


Instructions to use another version:

* start from the directory containing normaliz.lib
* run in Singular
    LIB "./normaliz.lib";
  the "./" ensures only a the local version is used
  
Quick test within subdirectory Singular of the Normaliz directory
(assuming Singular is installed and a binary is in the Normaliz directory):

* Singular < basic_test.sing

Gives output 

                     SINGULAR                                 /
 A Computer Algebra System for Polynomial Computations       /   version 4.0.3
                                                           0<
 by: W. Decker, G.-M. Greuel, G. Pfister, H. Schoenemann     \   Jan 2016
FB Mathematik der Universitaet, D-67653 Kaiserslautern        \  Debian 4.0.3+ds-1
// ** loaded normaliz.lib (4.0.2.0,Sept_2015)
_[1]=y
_[2]=x
hilbert_basis_elements : 2
number_extreme_rays : 2
dim_max_subspace : 0
embedding_dim : 2
rank : 2
external_index : 1
internal_index : 4
number_support_hyperplanes : 2
size_triangulation : 1
sum_dets : 1
integrally_closed : 0
inhomogeneous : 0
graded : 1
degree_1_elements : 2
grading : 1,1
grading_denom : 1
multiplicity : 1
multiplicity_denom : 1
hilbert_series_num : 1
hilbert_series_denom : 1,1
class_group : 0
Auf Wiedersehen.


Additional instructions for developers:

* get and compile Singular git version
    git clone https://github.com/Singular/Sources.git
    cd Singular.git
    mkdir BUILD; cd BUILD
    ../configure --with-flint=no

* compile libparse via

    cd Singular; make libparse

* build manual and run examples
   sudo apt-get install texinfo
   ... follow instructions of lib2doc webpage
   make normaliz.ps
   make normaliz.html

Recources:

general Singular compile instructions for Debian
https://github.com/Singular/Sources/wiki/Installation%20from%20GitHub%20on%20Debian


lib2doc Documentation tool
http://www.singular.uni-kl.de/Manual/latest/sing_60.htm#SEC96


