LAMMPS WWW Site - LAMMPS Documentation - LAMMPS Mailing List Archives
Re: [lammps-users] lammps-users Digest, Vol 143, Issue 53
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [lammps-users] lammps-users Digest, Vol 143, Issue 53

From: Steve Plimpton <sjplimp@...24...>
Date: Fri, 13 Apr 2018 07:13:08 -0600

>> The problem is that I find the many aspects of the organization of the documentation unintuitive, so I wasn’t able to find that through the searching I did. 

I think Noam's comment is on-point.  The LAMMPS doc pages and website info have grown
organically over the years, and are now vast and complicated.  It is often hard to
find the answer you're looking for, even for a power-user like Noam.

It's something we should try to simplify if we can find time to do it.


On Fri, Apr 13, 2018 at 6:22 AM, Axel Kohlmeyer <akohlmey@...24...> wrote:
On Fri, Apr 13, 2018 at 7:53 AM, Giacomo Fiorin
<giacomo.fiorin@...24...> wrote:
> From the doc:
> Typing “make package-update” or “make pu” will overwrite src files with
> files from the package sub-directories if the package is installed. It
> should be used after a patch has been applied, since patches only update the
> files in the package sub-directory, but not the src files.
> Is there perhaps a language barrier issue?

i would say that this is more of a "cultural" issue.

the LAMMPS manual is *vast* (>2000 pages) and for a very long time and
particularly in the beginning, the only way to obtain LAMMPS was via
downloading a tar archive or patch files from
a lot of the wording historically assumes that you obtain LAMMPS from
tar archives and patches and not subversion or git. some of the LAMMPS
core developers feel that this is the still the most common way and we
have no way of knowing whether this is the case or not.

also, the LAMMPS user base initially was much more that of people
doing development and less that of "i just want to use it" people.
thus there are parts in the documentation that make assumptions of its
readers that may not be as true as they used to be. it is difficult
for current developers to spot these (because for them these are
obvious things). it is best revised by people that are not developers,
as they know the perspective of a non-developer *much* better.


p.s.: noam, please fix your email or subscribe from a different
account. all replies to your address get rejected with messages like
this (which is hugely annoying):

** Message not delivered **

There was a problem delivering your message to
noam.bernstein@...4479.... See the technical details below, or try
resending in a few minutes.

The response from the remote server was:
554 5.7.1 Action Returned message to Sender:<akohlmey@...24...>,
Subject:Re: [lammps-users] lammps-users Digest, Vol 143, Issue 53,
Messages Rejected, Notify Recipient

Dr. Axel Kohlmeyer  akohlmey@...43...4...
College of Science & Technology, Temple University, Philadelphia PA, USA
International Centre for Theoretical Physics, Trieste. Italy.

Check out the vibrant tech community on one of the world's most
engaging tech sites,!
lammps-users mailing list