120004 - Need info on template and AppConfig in help docs

Status: RESOLVED FIXED

(Bugzilla :: Documentation, defect, P1)

Description

[Brian 'netdragon' Bober]

Template and AppConfig are not written about in Unix Docs (afaik).

For Win32, Template and AppConfig are available via links at
http://www.template-toolkit.org/download.html#win32. 
This should be added to the Win32 help docs

Comment 1

[Brian 'netdragon' Bober]

It should also be mentioned that there is an AppConfig in the 5.6Plus 
directory of ActiveState so that ppm might find that one instead and return an 
error like this:

Error installing package 'AppConfig': Read a PPD for 'AppConfig', but it is not
intended for this build of Perl (MSWin32-x86-multi-thread)

Therefore, you need to download both the tarball and ppd directly from 
http://openinteract.sourceforge.net/ppmpackages/ to some directory (we'll use 
C:\)
then run ppm and do:
install C:\AppConfig.ppd

Comment 2

[Dave Miller [:justdave]]

Need this in the docs before the 2.16 release

Comment 3

[Dave Miller [:justdave]]

Barnboy changed his email address and opened a new account instead of having the
address changed on his existing one.  Reassigning all docs bugs to his new account.

Comment 4

[Gregory Leblanc]

I can't create a patch for this one based on the information given.  I'm not
familiar enough with Windows to know if those instructions make sense, and I'm
pretty sure that they're not quite as clear as I'd like them to be.  If you'd
like to fire off another, slightly more explicit set of instructions, I'll get a
patch in here so that we make sure it's in the guide for the release. 

Comment 5

[Myk Melez [:myk] [@mykmelez]]

Here's a rewrite of step 3 of section 3.6.1 of the guide with the relevant
information integrated:

---
Use ppm from your perl\bin directory to install the following packs: 
DBI, DBD-Mysql, TimeDate, Chart, Date-Calc, Date-Manip, GD, AppConfig, 
and Template. You may need to extract them from .zip format using Winzip 
or other unzip program first. Most of these additional ppm modules 
can be downloaded from ActiveState, but AppConfig and Template 
should be obtained from OpenInteract using 
<a href="http://openinteract.sourceforge.net/">the instructions 
on the Template Toolkit web site</a>.

Note

You can find a list of modules at 
http://www.activestate.com/PPMPackages/zips/5xx-builds-only/
or
http://www.activestate.com/PPMPackages/5.6plus

The syntax for ppm is: C:> ppm <modulename>

Example 3-3. Installing ActivePerl ppd Modules on Microsoft Windows

C:>ppm DBD-Mysql

Watch your capitalization!

ActiveState's 5.6Plus directory also contains an AppConfig ppm,
so you might see the following error when trying to install
the version at OpenInteract:

Error installing package 'AppConfig': Read a PPD for 'AppConfig', but it is not
intended for this build of Perl (MSWin32-x86-multi-thread)

If so, download both <a
href="http://openinteract.sourceforge.net/ppmpackages/AppConfig.tar.gz">the
tarball</a> and <a
href="http://openinteract.sourceforge.net/ppmpackages/AppConfig.ppd">the ppd</a>
directly from OpenInteract, then run ppm from within the same directory 
to which you downloaded those files and install the package by referencing 
the ppd file explicitly via in the install command, f.e.:

Example 3-4 Installing OpenInteract ppd Modules manually on Microsoft Windows

install C:\AppConfig.ppd

---

Comment 6

[Gregory Leblanc]

Attachment: HTML generated from patched installation.sgml

Comment 7

[Gregory Leblanc]

Attachment: patch to the SGML code

Comment 8

[Dave Miller [:justdave]]

-> patch author

Comment 9

[Dave Miller [:justdave]]

Checking in installation.sgml;
/cvsroot/mozilla/webtools/bugzilla/docs/sgml/installation.sgml,v  <-- 
installation.sgml
new revision: 1.15; previous revision: 1.14
done

Comment 10

[Dave Miller [:justdave]]

we'll recompile and check in all the other formats last thing before release.