title should say we document modules here.

add documentation for d7 (and also d6, kind-of)

1 files changed, 55 insertions, 3 deletions

diff --git a/share/man/man5/port-modules.5 b/share/man/man5/port-modules.5
index 4161647ad8c..92d2f4bebd2 100644
--- a/share/man/man5/port-modules.5
+++ b/share/man/man5/port-modules.5
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: port-modules.5,v 1.135 2012/06/10 21:11:13 jasper Exp $
+.\"	$OpenBSD: port-modules.5,v 1.136 2012/06/11 10:09:07 espie Exp $
 .\"
 .\" Copyright (c) 2008 Marc Espie
 .\"
@@ -24,12 +24,12 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: June 10 2012 $
+.Dd $Mdocdate: June 11 2012 $
 .Dt PORT-MODULES 5
 .Os
 .Sh NAME
 .Nm port-modules
-.Nd format and conventions used in port modules
+.Nd documentation and conventions used in port modules
 .Sh DESCRIPTION
 The
 .Ox
@@ -901,7 +901,59 @@ by appending
 .Ev MODINTLTOOL_OVERRIDE
 to them.
 .It www/drupal6
+This module is legacy.
+drupal6 is still supported, but new work should mostly happen in drupal7 land.
 .It www/drupal7
+Can be used to install plugins (default), themes if
+.Ev MODDRUPAL_THEME
+is yes, or languages packs if
+.Ev DRUPAL_LANG
+is set to the desired language.
+.Pp
+The module will set or add to default values for
+.Ev HOMEPAGE ,
+.Ev MASTER_SITES ,
+.Ev PREFIX ,
+.Ev DIST_SUBDIR ,
+.Ev CATEGORIES ,
+.Ev PKG_ARCH ,
+.Ev WRKDIST ,
+.Ev RUN_DEPENDS .
+Drupal modules normally don't have any build part, just an installation part
+that defaults to copying the plugin/theme/language files into the right
+location through
+.Ev MODDRUPAL_INSTALL .
+.Pp
+The module sets
+.Ev DRUPAL
+to drupal7,
+.Ev DRUPAL_ROOT
+to htdocs/${DRUPAL}
+.Ev DRUPAL_MODS
+to ${DRUPAL_ROOT}/site/all/modules
+.Ev DRUPAL_THEMES
+to ${DRUPAL_ROOT}/site/all/themes
+and
+.Ev DRUPAL_TRANSLATIONS
+to ${DRUPAL_ROOT}/profiles/standard/translations.
+So, by default, modules and themes are installed for all sites,
+and translations are activated at install.
+.Pp
+.Ev DRUPAL_OWNER , DRUPAL_GROUP
+are set to root, daemon, since drupal doesn't need to write
+to any file except the files/ directory and the site settings (those
+belong to www instead).
+.Pp
+Translations are handled by setting
+.Ev DRUPAL_LANG
+to the language letter code, and by setting
+.Ev LANGFILES
+to a list of module names/version pairs.
+.Pp
+With drupal7, all translations have been put in separate .po files.
+It has been deemed simplest to pack all translations for a given language
+into a single package, since translations for non installed modules won't
+affect anything.
 .It www/horde
 .It www/mozilla
 Sets