From f4950af5437c17a6048106d20e9b61bc437ba2f7 Mon Sep 17 00:00:00 2001 From: Carsten Dominik Date: Sun, 4 Apr 2010 02:12:48 +0200 Subject: [PATCH] More rephrasing of the changes in LaTeX export --- ORGWEBPAGE/Changes.org | 21 ++++++++++----------- lisp/org.el | 25 ++++++++++++++++++------- 2 files changed, 28 insertions(+), 18 deletions(-) diff --git a/ORGWEBPAGE/Changes.org b/ORGWEBPAGE/Changes.org index 42a88c093..76424fd8f 100644 --- a/ORGWEBPAGE/Changes.org +++ b/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=. diff --git a/lisp/org.el b/lisp/org.el index ca41b6718..ee8cf3315 100644 --- a/lisp/org.el +++ b/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 -- 2.11.4.GIT