More rephrasing of the changes in LaTeX export

ORGWEBPAGE/Changes.org

@@ -24,24 +24,23 @@ for example for the special symbol support it needs.
 
 There are now two variables that should be used to list the LaTeX
 packages that need to be included in all classes.  The header
-definition in =org-export-latex-classes= should then only contain
-the =\documentclass= macro, and packages for this specific class
+definition in =org-export-latex-classes= should then contain
+the =\documentclass= macro and packages for this specific class
 definition.
 
 The two variables are:
 
 1. =org-export-latex-default-packages-alist= :: This is the
      variable where Org-mode itself puts the packages it needs.
-     If possible, you should not change this variable - in fact,
-     I have considered to make this a constant and to not allow
-     it customized.  However, there is one exception when it
-     might be necessary to change it: if one of the packages
+     The only reason to change it is when one of these packages
      causes a conflict with another package you want to use.
+     Then you can remove that packages and hope that you are not
+     using Org-mode functionality that needs it.
 
 2. =org-export-latex-packages-alist= :: This is the variable
-     where you should put the packages that you'd like to use
-     across all classes.  For example, I am putting =amsmath= and
-     =tikz= here, because I always want to have them.
+     where you can put the packages that you'd like to use across
+     all classes.  For example, I am putting =amsmath= and =tikz=
+     here, because I always want to have them.
 
 The sequence how these customizations will show up in the LaTeX
 document are:
@@ -52,8 +51,8 @@ document are:
 
 If you have currently customized =org-export-latex-classes=, you
 should revise that customization and remove any package call that
-are covered by =org-export-latex-default-packages-alist=, and you
-should consider to move packages that you use in all classes to
+are covered by =org-export-latex-default-packages-alist=.  You
+can also consider moving packages that you use in all classes to
 =org-export-latex-packages-alist=.
 
 

lisp/org.el

@@ -2950,13 +2950,24 @@ appears on the page."
     (""     "latexsym")
     (""     "amssymb")
     (""     "hyperref"))
-  "Alist of default packages to be inserted in the header. DON'T CHANGE THIS.
-Unless abslutely necessary that is.
-All the packages in this list are needed by one part or another of Org-mode
-to function properly.  Therefore you should, not modify this variable unless
-you know what you are doing.  The one reason to change it anyway is that
-you might be loading some other package that conflicts with one of the default
-packages.
+  "Alist of default packages to be inserted in the header.
+Change this only if one of the packages here causes an incompatibility
+with another package you are using.
+The packages in this list are needed by one part or another of Org-mode
+to function properly.  
+
+- inputenc, fontenc, t1enc: for basic font and character selection
+- textcomp, marvosymb, wasysym, latexsym, amssym: for various symbols used
+  for interpreting the entities in `org-entities'.  You can skip some of these
+  packages if you don't use any of the symbols in it.
+- graphicx: for including images
+- float, wrapfig: for figure placement
+- longtable: for long tables
+- hyperref: for cross references
+
+Therefore you should not modify this variable unless you know what you
+are doing.  The one reason to change it anyway is that you might be loading
+some other package that conflicts with one of the default packages.
 Each cell is of the format \( \"options\" \"package\" \)."
   :group 'org-export-latex
   :type '(repeat