Merge pull request #1074 from akohlmey/more-doc-fixes

Add conversion from ePUB to MOBI e-book format to doc Makefile

doc/Makefile

@@ -31,7 +31,7 @@ SPHINXEXTRA = -j $(shell $(PYTHON) -c 'import multiprocessing;print(multiprocess
 SOURCES=$(filter-out $(wildcard src/lammps_commands*.txt) src/lammps_support.txt src/lammps_tutorials.txt,$(wildcard src/*.txt))
 OBJECTS=$(SOURCES:src/%.txt=$(RSTDIR)/%.rst)
 
-.PHONY: help clean-all clean epub html pdf old venv spelling anchor_check
+.PHONY: help clean-all clean epub mobi html pdf old venv spelling anchor_check
 
 # ------------------------------------------
 
@@ -42,6 +42,8 @@ help:
 	@echo "  old        create old-style HTML doc pages in old dir"
 	@echo "  fetch      fetch HTML and PDF files from LAMMPS web site"
 	@echo "  epub       create ePUB format manual for e-book readers"
+	@echo "  mobi       convert ePUB to MOBI format manual for e-book readers (e.g. Kindle)"
+	@echo "                      (requires ebook-convert tool from calibre)"
 	@echo "  clean      remove all intermediate RST files"
 	@echo "  clean-all  reset the entire build environment"
 	@echo "  txt2html   build txt2html tool"
@@ -106,6 +108,11 @@ epub: $(OBJECTS)
 	@rm -rf epub
 	@echo "Build finished. The ePUB manual file is created."
 
+mobi: epub
+	@rm -f LAMMPS.mobi
+	@ebook-convert LAMMPS.epub LAMMPS.mobi
+	@echo "Conversion finished. The MOBI manual file is created."
+
 pdf: utils/txt2html/txt2html.exe
 	@(\
 		set -e; \

doc/src/Build_basics.txt

@@ -61,7 +61,7 @@ library files.  Failing this, these 3 variables can be used to specify
 where the mpi.h file (MPI_INC), and the MPI library files (MPI_PATH)
 are found, and the name of the library files (MPI_LIB).
 
-For a serial build, you need to specify the 3 varaibles, as shown
+For a serial build, you need to specify the 3 variables, as shown
 above.
 
 For a serial LAMMPS build, use the dummy MPI library provided in
@@ -145,7 +145,7 @@ By default CMake will use a compiler it finds and it will add
 optimization flags appropriate to that compiler and any "accelerator
 packages"_Speed_packages.html you have included in the build.
 
-You can tell CMake to look for a specific compiler with these varaible
+You can tell CMake to look for a specific compiler with these variable
 settings.  Likewise you can specify the FLAGS variables if you want to
 experiment with alternate optimization flags.  You should specify all
 3 compilers, so that the small number of LAMMPS source files written
@@ -216,8 +216,8 @@ LAMMPS can be built as either an executable or as a static or shared
 library.  The LAMMPS library can be called from another application or
 a scripting language.  See the "Howto couple"_Howto_couple.html doc
 page for more info on coupling LAMMPS to other codes.  See the
-"Python"_Python doc page for more info on wrapping and running LAMMPS
-from Python via its library interface.
+"Python"_Python_head.html doc page for more info on wrapping and
+running LAMMPS from Python via its library interface.
 
 [CMake variables]:
 
@@ -247,7 +247,7 @@ Note that for a shared library to be usable by a calling program, all
 the auxiliary libraries it depends on must also exist as shared
 libraries.  This will be the case for libraries included with LAMMPS,
 such as the dummy MPI library in src/STUBS or any package libraries in
-the lib/packages directroy, since they are always built as shared
+the lib/packages directory, since they are always built as shared
 libraries using the -fPIC switch.  However, if a library like MPI or
 FFTW does not exist as a shared library, the shared library build will
 generate an error.  This means you will need to install a shared
@@ -299,7 +299,7 @@ Install LAMMPS after a build :h4,link(install)
 After building LAMMPS, you may wish to copy the LAMMPS executable of
 library, along with other LAMMPS files (library header, doc files) to
 a globally visible place on your system, for others to access.  Note
-that you may need super-user priveleges (e.g. sudo) if the directory
+that you may need super-user privileges (e.g. sudo) if the directory
 you want to copy files to is protected.
 
 [CMake variable]:

doc/src/Build_cmake.txt

@@ -40,7 +40,7 @@ executable called "lmp" and a library called "liblammps.a" in the
 If your machine has multiple CPU cores (most do these days), using a
 command like "make -jN" (with N being the number of available local
 CPU cores) can be much faster.  If you plan to do development on
-LAMMPS or need to recompile LAMMPS repeatedly, installation of the
+LAMMPS or need to re-compile LAMMPS repeatedly, installation of the
 ccache (= Compiler Cache) software may speed up compilation even more.
 
 After compilation, you can optionally copy the LAMMPS executable and
@@ -50,7 +50,7 @@ make install    # optional, copy LAMMPS executable & library elsewhere :pre
 
 :line
 
-There are 3 variants of CMake: a command-line verison (cmake), a text mode
+There are 3 variants of CMake: a command-line version (cmake), a text mode
 UI version (ccmake), and a graphical GUI version (cmake-GUI).  You can use
 any of them interchangeably to configure and create the LAMMPS build
 environment.  On Linux all the versions produce a Makefile as their
@@ -188,7 +188,7 @@ module list            # is a cmake module already loaded?
 module avail           # is a cmake module available?
 module load cmake3     # load cmake module with appropriate name :pre
 
-Most Linux distributions offer precompiled cmake packages through
+Most Linux distributions offer pre-compiled cmake packages through
 their package management system. If you do not have CMake or a new
 enough version, you can download the latest version at
 "https://cmake.org/download/"_https://cmake.org/download/.

doc/src/Build_extras.txt

@@ -340,7 +340,7 @@ NOTE: the use of the MEAM package is discouraged, as it has been
 superseded by the USER-MEAMC package, which is a direct translation of
 the Fortran code in the MEAM library to C++. The code in USER-MEAMC
 should be functionally equivalent to the MEAM package, fully supports
-use of "pair_style hybrid"_pair_hybrid.html (the MEAM packaged doesn
+use of "pair_style hybrid"_pair_hybrid.html (the MEAM package does
 not), and has optimizations that make it significantly faster than the
 MEAM package.
 
@@ -470,7 +470,7 @@ lib/python/README for more details.
 
 -D PYTHON_EXECUTABLE=path   # path to Python executable to use :pre
 
-Without this setting, CMake will ues the default Python on your
+Without this setting, CMake will guess the default Python on your
 system.  To use a different Python version, you can either create a
 virtualenv, activate it and then run cmake.  Or you can set the
 PYTHON_EXECUTABLE variable to specify which Python interpreter should
@@ -687,7 +687,7 @@ the HDF5 library.
 
 No additional settings are needed besides "-D PKG_USER-H5MD=yes".
 
-This should autodetect the H5MD library on your system.  Several
+This should auto-detect the H5MD library on your system.  Several
 advanced CMake H5MD options exist if you need to specify where it is
 installed.  Use the ccmake (terminal window) or cmake-gui (graphical)
 tools to see these options and set them interactively from their user
@@ -777,7 +777,7 @@ on your system.
 
 No additional settings are needed besides "-D PKG_USER-NETCDF=yes".
 
-This should autodetect the NETCDF library if it is installed on your
+This should auto-detect the NETCDF library if it is installed on your
 system at standard locations.  Several advanced CMake NETCDF options
 exist if you need to specify where it was installed.  Use the ccmake
 (terminal window) or cmake-gui (graphical) tools to see these options
@@ -905,7 +905,7 @@ Eigen3 is a template library, so you do not need to build it.
 -D EIGEN3_INCLUDE_DIR=path    # path to Eigen library (only needed if a custom location) :pre
 
 If DOWNLOAD_EIGEN3 is set, the Eigen3 library will be downloaded and
-inside the CMake build directory.  If the Eig3n3 library is already on
+inside the CMake build directory.  If the Eigen3 library is already on
 your system (in a location CMake cannot find it), EIGEN3_INCLUDE_DIR
 is the directory the Eigen3++ include file is in.
 
@@ -936,7 +936,7 @@ your system.
 
 No additional settings are needed besides "-D PKG_USER-VTK=yes".
 
-This should autodetect the VTK library if it is installed on your
+This should auto-detect the VTK library if it is installed on your
 system at standard locations.  Several advanced VTK options exist if
 you need to specify where it was installed.  Use the ccmake (terminal
 window) or cmake-gui (graphical) tools to see these options and set

doc/src/Build_make.txt

@@ -35,16 +35,16 @@ This initial compilation can take a long time, since LAMMPS is a large
 project with many features. If your machine has multiple CPU cores
 (most do these days), using a command like "make -jN mpi" (with N =
 the number of available CPU cores) can be much faster.  If you plan to
-do development on LAMMPS or need to recompile LAMMPS repeatedly, the
+do development on LAMMPS or need to re-compile LAMMPS repeatedly, the
 installation of the ccache (= Compiler Cache) software may speed up
 compilation even more.
 
 After the initial build, whenever you edit LAMMPS source files, or add
 or remove new files to the source directory (e.g. by installing or
-uninstalling packages), you must recompile and relink the LAMMPS
+uninstalling packages), you must re-compile and relink the LAMMPS
 executable with the same "make" command.  This makefiles dependencies
 should insure that only the subset of files that need to be are
-recompiled.
+re-compiled.
 
 NOTE: When you build LAMMPS for the first time, a long list of *.d
 files will be printed out rapidly.  This is not an error; it is the
@@ -71,8 +71,8 @@ Makefiles you may wish to try include these (some require a package
 first be installed).  Many of these include specific compiler flags
 for optimized performance.  Please note, however, that some of these
 customized machine Makefile are contributed by users.  Since both
-compilers, OS configs, and LAMMPS itself keep changing, their settings
-may become outdated:
+compilers, OS configurations, and LAMMPS itself keep changing, their
+settings may become outdated:
 
 make mac             # build serial LAMMPS on a Mac
 make mac_mpi         # build parallel LAMMPS on a Mac

doc/src/Build_settings.txt

@@ -80,8 +80,8 @@ per-timestep CPU cost, FFTs are only a portion of long-range
 Coulombics, and 1d FFTs are only a portion of the FFT cost (parallel
 communication can be costly).  A breakdown of these timings is printed
 to the screen at the end of a run using the "kspace_style
-pppm"_kspace_style.html command.  The "Run output"_doc page gives more
-details.
+pppm"_kspace_style.html command.  The "Run output"_Run_output.html
+doc page gives more details.
 
 FFTW is a fast, portable FFT library that should also work on any
 platform and can be faster than the KISS FFT library.  You can
@@ -101,7 +101,7 @@ Performing 3d FFTs in parallel can be time consuming due to data
 access and required communication.  This cost can be reduced by
 performing single-precision FFTs instead of double precision.  Single
 precision means the real and imaginary parts of a complex datum are
-4-byte floats.  Double precesion means they are 8-byte doubles.  Note
+4-byte floats.  Double precision means they are 8-byte doubles.  Note
 that Fourier transform and related PPPM operations are somewhat less
 sensitive to floating point truncation errors and thus the resulting
 error is less than the difference in precision. Using the -DFFT_SINGLE
@@ -193,7 +193,7 @@ Output of JPG, PNG, and movie files :h4,link(graphics)
 
 The "dump image"_dump_image.html command has options to output JPEG or
 PNG image files.  Likewise the "dump movie"_dump_image.html command
-ouputs movie files in MPEG format.  Using these options requires the
+outputs movie files in MPEG format.  Using these options requires the
 following settings:
 
 [CMake variables]:
@@ -206,7 +206,7 @@ following settings:
                           # default = yes if CMake can find ffmpeg, else no :pre
 
 Usually these settings are all that is needed.  If CMake cannot find
-the graphics header, library, executuable files, you can set these
+the graphics header, library, executable files, you can set these
 variables:
 
 -D JPEG_INCLUDE_DIR=path    # path to jpeglib.h header file 

doc/src/Build_windows.txt

@@ -84,7 +84,7 @@ with the cross-compiler environment on Fedora machines.
 Please keep in mind, though, that this only applies to compiling LAMMPS.
 Whether the resulting binaries do work correctly is no tested by the
 LAMMPS developers.  We instead rely on the feedback of the users
-of these precompiled LAMMPS packages for Windows.  We will try to resolve
+of these pre-compiled LAMMPS packages for Windows.  We will try to resolve
 issues to the best of our abilities if we become aware of them. However
 this is subject to time constraints and focus on HPC platforms.
 

doc/src/Commands_all.txt

@@ -19,7 +19,7 @@ Documentation"_ld - "LAMMPS Commands"_lc :c
 
 All commands :h3
 
-An alphabetic list of all LAMMPS commmands.
+An alphabetic list of all LAMMPS commands.
 
 "angle_coeff"_angle_coeff.html,
 "angle_style"_angle_style.html,

doc/src/Commands_bond.txt

@@ -95,7 +95,7 @@ OPT.
 "helix (o)"_dihedral_helix.html,
 "multi/harmonic (o)"_dihedral_multi_harmonic.html,
 "nharmonic (o)"_dihedral_nharmonic.html,
-"opls (iko)"_dihedral_opls.htm;,
+"opls (iko)"_dihedral_opls.html,
 "quadratic (o)"_dihedral_quadratic.html,
 "spherical (o)"_dihedral_spherical.html,
 "table (o)"_dihedral_table.html,

doc/src/Commands_parse.txt

@@ -14,7 +14,7 @@ LAMMPS commands are case sensitive.  Command names are lower-case, as
 are specified command arguments.  Upper case letters may be used in
 file names or user-chosen ID strings.
 
-Here are 6 rulse for how each line in the input script is parsed by
+Here are 6 rules for how each line in the input script is parsed by
 LAMMPS:
 
 (1) If the last printable character on the line is a "&" character,
@@ -71,7 +71,7 @@ floating-point value.  The format string is used to output the result
 of the variable expression evaluation.  If a format string is not
 specified a high-precision "%.20g" is used as the default.
 
-This can be useful for formatting print output to a desired precion:
+This can be useful for formatting print output to a desired precision:
 
 print "Final energy per atom: $(pe/atoms:%10.3f) eV/atom" :pre
 

doc/src/Errors_messages.txt

@@ -743,7 +743,7 @@ Self-explanatory. :dd
 
 Self-explanatory. :dd
 
-{Cannot (yet) use single precision with MSM (remove -DFFT_SINGLE from Makefile and recompile)} :dt
+{Cannot (yet) use single precision with MSM (remove -DFFT_SINGLE from Makefile and re-compile)} :dt
 
 Single precision cannot be used with MSM. :dd
 
@@ -5078,7 +5078,7 @@ Self-explanatory. :dd
 
 Occurs when number of neighbor atoms for an atom increased too much
 during a run.  Increase SAFE_ZONE and MIN_CAP in fix_qeq.h and
-recompile. :dd
+re-compile. :dd
 
 {Fix qeq/point requires atom attribute q} :dt
 
@@ -5092,7 +5092,7 @@ Self-explanatory. :dd
 
 Occurs when number of neighbor atoms for an atom increased too much
 during a run.  Increase SAFE_ZONE and MIN_CAP in fix_qeq.h and
-recompile. :dd
+re-compile. :dd
 
 {Fix qeq/shielded requires atom attribute q} :dt
 
@@ -5110,7 +5110,7 @@ Self-explanatory. :dd
 
 Occurs when number of neighbor atoms for an atom increased too much
 during a run.  Increase SAFE_ZONE and MIN_CAP in fix_qeq.h and
-recompile. :dd
+re-compile. :dd
 
 {Fix qeq/slater requires atom attribute q} :dt
 
@@ -5541,7 +5541,7 @@ See the package gpu command. :dd
 
 {GPUs are requested but Kokkos has not been compiled for CUDA} :dt
 
-Recompile Kokkos with CUDA support to use GPUs. :dd
+Re-compile Kokkos with CUDA support to use GPUs. :dd
 
 {Ghost velocity forward comm not yet implemented with Kokkos} :dt
 

doc/src/Errors_warnings.txt

@@ -13,7 +13,7 @@ This is an alphabetic list of the WARNING messages LAMMPS prints out
 and the reason why.  If the explanation here is not sufficient, the
 documentation for the offending command may help.  Warning messages
 also list the source file and line number where the warning was
-generated.  For example, a message lile this:
+generated.  For example, a message like this:
 
 WARNING: Bond atom missing in box size check (domain.cpp:187) :pre
 

doc/src/Howto_barostat.txt

@@ -64,11 +64,11 @@ Thermodynamic output, which can be setup via the
 "thermo_style"_thermo_style.html command, often includes pressure
 values.  As explained on the doc page for the
 "thermo_style"_thermo_style.html command, the default pressure is
-setup by the thermo command itself.  It is NOT the presure associated
+setup by the thermo command itself.  It is NOT the pressure associated
 with any barostatting fix you have defined or with any compute you
-have defined that calculates a presure.  The doc pages for the
+have defined that calculates a pressure.  The doc pages for the
 barostatting fixes explain the ID of the pressure compute they create.
-Thus if you want to view these pressurse, you need to specify them
+Thus if you want to view these pressures, you need to specify them
 explicitly via the "thermo_style custom"_thermo_style.html command.
 Or you can use the "thermo_modify"_thermo_modify.html command to
 re-define what pressure compute is used for default thermodynamic

doc/src/Howto_body.txt

@@ -337,7 +337,7 @@ the sphere that surrounds each vertex. The diameter value can be
 different for each body particle. These floating-point values can be
 listed on as many lines as you wish; see the
 "read_data"_read_data.html command for more details.  Because the
-maxmimum vertices per face is hard-coded to be 4
+maximum number of vertices per face is hard-coded to be 4
 (i.e. quadrilaterals), faces with more than 4 vertices need to be
 split into triangles or quadrilaterals.  For triangular faces, the
 last vertex index should be set to -1.

doc/src/Howto_library.txt

@@ -171,16 +171,16 @@ void lammps_create_atoms(void *, int, tagint *, int *, double *, double *,
 
 The gather functions collect peratom info of the requested type (atom
 coords, atom types, forces, etc) from all processors, and returns the
-same vector of values to each callling processor.  The scatter
+same vector of values to each calling processor.  The scatter
 functions do the inverse.  They distribute a vector of peratom values,
-passed by all calling processors, to invididual atoms, which may be
-owned by different processos.
+passed by all calling processors, to individual atoms, which may be
+owned by different processors.
 
 The lammps_gather_atoms() function does this for all N atoms in the
 system, ordered by atom ID, from 1 to N.  The
 lammps_gather_atoms_concat() function does it for all N atoms, but
 simply concatenates the subset of atoms owned by each processor.  The
-resulting vector is not ordered by atom ID.  Atom IDs can be requetsed
+resulting vector is not ordered by atom ID.  Atom IDs can be requested
 by the same function if the caller needs to know the ordering.  The
 lammps_gather_subset() function allows the caller to request values
 for only a subset of atoms (identified by ID).

doc/src/Howto_pylammps.txt

@@ -73,7 +73,7 @@ that package into your current Python installation.
 cd $LAMMPS_DIR/python
 python install.py :pre
 
-NOTE: Recompiling the shared library requires reinstalling the Python package
+NOTE: Recompiling the shared library requires re-installing the Python package
 
 
 Installation inside of a virtualenv :h5

doc/src/Howto_spherical.txt

@@ -159,7 +159,7 @@ ellipsoidal particles:
 
 The advantage of these fixes is that those which thermostat the
 particles include the rotational degrees of freedom in the temperature
-calculation and thermostatting.  The "fix langevin"_fix_langevin
+calculation and thermostatting.  The "fix langevin"_fix_langevin.html
 command can also be used with its {omgea} or {angmom} options to
 thermostat the rotational degrees of freedom for spherical or
 ellipsoidal particles.  Other thermostatting fixes only operate on the

doc/src/Howto_spins.txt

@@ -9,10 +9,10 @@ Documentation"_ld - "LAMMPS Commands"_lc :c
 
 Magnetic spins :h3
 
-The magnetic spin simualtions are enabled by the SPIN package, whose
+The magnetic spin simulations are enabled by the SPIN package, whose
 implementation is detailed in "Tranchida"_#Tranchida7.
 
-The model representents the simulation of atomic magnetic spins coupled 
+The model represents the simulation of atomic magnetic spins coupled 
 to lattice vibrations. The dynamics of those magnetic spins can be used 
 to simulate a broad range a phenomena related to magneto-elasticity, or 
 or to study the influence of defects on the magnetic properties of 
@@ -43,7 +43,7 @@ langevin/spin"_fix_langevin_spin.html. It allows to either dissipate
 the thermal energy of the Langevin thermostat, or to perform a 
 relaxation of the magnetic configuration toward an equilibrium state.
 
-All the computed magnetic properties can be outputed by two main 
+All the computed magnetic properties can be output by two main 
 commands. The first one is "compute spin"_compute_spin.html, that 
 enables to evaluate magnetic averaged quantities, such as the total 
 magnetization of the system along x, y, or z, the spin temperature, or

doc/src/Install_patch.txt

@@ -17,10 +17,11 @@ how to stay current are on the "Install git"_Install_git.html and
 If you prefer to download a tarball, as described on the "Install
 git"_Install_tarball.html doc page, you can stay current by
 downloading "patch files" when new patch releases are made.  A link to
-a patch file is posted on the "bug and feature page"_bug of the
-website, along with a list of changed files and details about what is
-in the new patch release.  This page explains how to apply the patch
-file to your local LAMMPS directory.
+a patch file is posted on the "bug and feature 
+page"_http://lammps.sandia.gov/bug.html of the LAMMPS website, along
+with a list of changed files and details about what is in the new patch
+release.  This page explains how to apply the patch file to your local
+LAMMPS directory.
 
 NOTE: You should not apply patch files to a local Git or SVN repo of
 LAMMPS, only to an unpacked tarball.  Use Git and SVN commands to

doc/src/Intro_overview.txt

@@ -17,7 +17,7 @@ variety of interatomic potentials (force fields) and boundary
 conditions.  It can model 2d or 3d systems with only a few particles
 up to millions or billions.
 
-LAMMPS can be built and run on a laptop or destop machine, but is
+LAMMPS can be built and run on a laptop or desktop machine, but is
 designed for parallel computers.  It will run on any parallel machine
 that supports the "MPI"_mpi message-passing library.  This includes
 shared-memory boxes and distributed-memory clusters and
@@ -45,7 +45,7 @@ nature; some long-range models are included as well.
 LAMMPS uses neighbor lists to keep track of nearby particles.  The
 lists are optimized for systems with particles that are repulsive at
 short distances, so that the local density of particles never becomes
-too large.  This is in contrast to methods used for modeling plasmas
+too large.  This is in contrast to methods used for modeling plasma
 or gravitational bodies (e.g. galaxy formation).
 
 On parallel machines, LAMMPS uses spatial-decomposition techniques to