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

git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@10876 f3b2605a-c512-4ea7-a41b-209d697bcdaa

Browse Source
This commit is contained in:
sjplimp
2013-10-24 18:04:27 +00:00
parent 09c8526430
commit b0d7fe1f26
2 changed files with 40 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files

31
doc/Section_modify.html
View File

@ -661,13 +661,13 @@ it if LAMMPS changes.
features of various kinds to LAMMPS. Packages are simply collections
of one or more new class files which are invoked as a new "style"
within a LAMMPS input script. If designed correctly, these additions
do not require changes to the main core of LAMMPS; they are simply
add-on files. If you think your new feature requires non-trivial
changes in core LAMMPS files, you'll need to <A HREF = "http://lammps.sandia.gov/authors.html">communicate with the
developers</A>, since we may or may
not want to make those changes. An example of a trivial change is
making a parent-class method "virtual" when you derive a new child
class from it.
typically do not require changes to the main core of LAMMPS; they are
simply add-on files. If you think your new feature requires
non-trivial changes in core LAMMPS files, you'll need to <A HREF = "http://lammps.sandia.gov/authors.html">communicate
with the developers</A>, since we
may or may not want to make those changes. An example of a trivial
change is making a parent-class method "virtual" when you derive a new
child class from it.
</P>
<P>Here is what you need to do to submit a user package or single file
for our consideration. Following these steps will save time for both
@ -676,6 +676,14 @@ you and us. See existing package files for examples.
<UL><LI>All source files you provide must compile with the most current
version of LAMMPS.
<LI>If you want your file(s) to be added to main LAMMPS or one of its
standard packages, then it needs to be written in a style compatible
with other LAMMPS source files. This is so the developers can
understand it and hopefully maintain it. This basically means that
the code accesses data structures, performs its operations, and is
formatted similar to other LAMMPS source files, including the use of
the error class for error and warning messages.
<LI>If your contribution is a single file (actually a *.cpp and *.h file)
it can most rapidly be added to the USER-MISC directory. Send us the
one-line entry to add to the USER-MISC/README file in that dir, along
@ -694,10 +702,11 @@ directory.
<LI>Your new source files need to have the LAMMPS copyright, GPL notice,
and your name at the top, like other LAMMPS source files. They need
to create a class that is inside the LAMMPS namespace. Other than
that, your files can do whatever is necessary to implement the new
features. They don't have to be written in the same stylistic format
and syntax as other LAMMPS files, though that would be nice.
to create a class that is inside the LAMMPS namespace. If the file is
for one of the USER packages, including USER-MISC, then we are not as
picky about the coding style (see above). I.e. they do not need to be
in the same stylistic format and syntax as other LAMMPS files, though
that would be nice.
<LI>Finally, you must also send a documentation file for each new command
or style you are adding to LAMMPS. This will be one file for a