Need info on template and AppConfig in help docs

RESOLVED FIXED in Bugzilla 2.16

Status

()

Bugzilla
Documentation
P1
blocker
RESOLVED FIXED
17 years ago
6 years ago

People

(Reporter: Brian 'netdragon' Bober, Assigned: Gregory Leblanc)

Tracking

unspecified
Bugzilla 2.16

Details

Attachments

(2 attachments)

(Reporter)

Description

17 years ago
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
(Reporter)

Comment 1

17 years ago
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
Need this in the docs before the 2.16 release
Severity: normal → blocker
Priority: -- → P1
Target Milestone: --- → Bugzilla 2.16
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.
Assignee: barnboy → mbarnson
(Assignee)

Comment 4

16 years ago
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. 
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

---
(Assignee)

Comment 6

16 years ago
Created attachment 79685 [details]
HTML generated from patched installation.sgml
(Assignee)

Comment 7

16 years ago
Created attachment 79687 [details] [diff] [review]
patch to the SGML code
Keywords: patch, review
-> patch author
Assignee: mbarnson → gleblanc
Checking in installation.sgml;
/cvsroot/mozilla/webtools/bugzilla/docs/sgml/installation.sgml,v  <-- 
installation.sgml
new revision: 1.15; previous revision: 1.14
done
Status: NEW → RESOLVED
Last Resolved: 16 years ago
Resolution: --- → FIXED
we'll recompile and check in all the other formats last thing before release.
QA Contact: matty_is_a_geek → default-qa
You need to log in before you can comment on or make changes to this bug.