ICODE-ADC/lammps
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

update documentation for the conventional build

Browse Source
This commit is contained in:
Axel Kohlmeyer
2020-02-20 17:33:57 +01:00
parent 0db0d5408a
commit 1c8b7022a3
2 changed files with 28 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

40
doc/src/Build_make.rst
View File

@ -7,15 +7,27 @@ src/MAKE/MACHINES, src/MAKE/OPTIONS, or src/MAKE/MINE directory (see
below). It can include various options for customizing your LAMMPS below). It can include various options for customizing your LAMMPS
build with a number of global compilation options and features. build with a number of global compilation options and features.
To include LAMMPS packages (i.e. optional commands and styles) you Those makefiles are written for and tested with GNU make and may not
must install them first, as discussed on the :doc:`Build package <Build_package>` doc page. If the packages require be compatible with other make programs. In most cases, if the "make"
provided or external libraries, you must build those libraries before program is not GNU make, then it will be installed as "gmake". If
building LAMMPS. Building :doc:`LAMMPS with CMake <Build_cmake>` can GNU make or a compatible make is not available, you may have to first
automate all of this for many types of machines, especially install it. These makefiles and the scripts they are calling expect
workstations, desktops and laptops, so we suggest you try it first. a few additional tools to be available and functioning.
These commands perform a default LAMMPS build, producing the LAMMPS * a Bourne shell compatible "Unix" shell program (often this is bash)
executable lmp\_serial or lmp\_mpi in lammps/src: * a few shell utilities: ls, mv, ln, rm, grep, sed, tr, cat, touch, diff, dirname
* python (optional, required for "make lib-XXX" in the src folder)
To include LAMMPS packages (i.e. optional commands and styles) you
must enable them first, as discussed on the :doc:`Build package
<Build_package>` doc page. If a packages requires (provided or
external) libraries, you must build those libraries before building
LAMMPS. Building :doc:`LAMMPS with CMake <Build_cmake>` can automate
much of this for many types of machines, especially workstations,
desktops and laptops, so we suggest you try it first.
The commands below perform a default LAMMPS build, producing the LAMMPS
executable lmp\_serial and lmp\_mpi in lammps/src:
.. code-block:: bash .. code-block:: bash
@ -42,14 +54,16 @@ re-compiled.
.. note:: .. note::
When you build LAMMPS for the first time, a long list of \*.d Before the actual compilation starts, LAMMPS will perform several
files will be printed out rapidly. This is not an error; it is the steps to collect information from the configuration and setup that
Makefile doing its normal creation of dependencies. is then embedded into the executable. When you build LAMMPS for
the first time, it will also compile a tool to quickly assemble
a list of dependencies, that are required for the make program to
correctly detect which parts need to be recompiled after changes
were made to the sources.
---------- ----------
The lammps/src/MAKE tree contains all the Makefile.machine files The lammps/src/MAKE tree contains all the Makefile.machine files
included in the LAMMPS distribution. Typing "make machine" uses included in the LAMMPS distribution. Typing "make machine" uses
Makefile.machine. Thus the "make serial" or "make mpi" lines above Makefile.machine. Thus the "make serial" or "make mpi" lines above

1
doc/utils/sphinx-config/false_positives.txt
View File

@ -613,6 +613,7 @@ dimgray
dipolar dipolar
dir dir
Direc Direc
dirname
dirs dirs
discoverable discoverable
discretization discretization