[doc] Problems making manual

Jon Parise jon@horde.org
Mon, 8 Oct 2001 10:46:59 -0400


On Mon, Oct 08, 2001 at 04:28:49PM +0200, Jan Schneider wrote:

> > > I have problems creating the manual with make or make html. 
> > > 
> > > The error messages sound like: 
> > > /usr/bin/openjade:./html.dsl:1:73:W: cannot generate system identifier for
> > 
> > > public text "-//James Clark//DTD DSSSL Style Sheet//EN" 
> > > /usr/bin/openjade:./html.dsl:5:0:E: reference to entity "STYLE-SHEET" for
> > which 
> > > no system identifier could be generated 
> > > 
> > > There are a bunch of more messages that probably depend on the first ones.
> > 
> > > 
> > > Installed is openjade, DocBook 4 DTD and the DocBook DSSSL stylesheet by
> > Norman 
> > > Walsh. 
> >  
> > I'm not sure.  I'm using jade 1.2.1 (ftp://ftp.jclark.com/pub/jade/),
> > and it works fine.
> 
> I just gave this jade version a try and get exactly the same error messages.
 
Strange.  Maybe it has something to do with the stylesheet.  I'm
using: dsssl-docbook-modular-1.71

-- 
Jon Parise (jon@csh.rit.edu)  .  Information Technology (2001)
http://www.csh.rit.edu/~jon/  :  Computer Science House Member


>From jan@horde.org Date: Mon,  8 Oct 2001 17:32:49 +0200
Return-Path: <jan@horde.org>
Mailing-List: contact doc-help@lists.horde.org; run by ezmlm
Delivered-To: mailing list doc@lists.horde.org
Received: (qmail 54935 invoked from network); 8 Oct 2001 15:34:39 -0000
Received: from mailout05.sul.t-online.com (HELO mailout05.sul.t-online.de) (194.25.134.82)
  by clark.horde.org with SMTP; 8 Oct 2001 15:34:39 -0000
Received: from fwd03.sul.t-online.de 
	by mailout05.sul.t-online.de with smtp 
	id 15qcQQ-0001mB-03; Mon, 08 Oct 2001 17:34:38 +0200
Received: from linux.wg.de (320034214675-0001@[217.0.157.79]) by fmrl03.sul.t-online.com
	with esmtp id 15qcQ0-1pue8WC; Mon, 8 Oct 2001 17:34:12 +0200
Received: from localhost (localhost [127.0.0.1])
	by linux.wg.de (8.11.0/8.11.0/SuSE Linux 8.11.0-0.4) with ESMTP id f98FWpc19137
	for <doc@lists.horde.org>; Mon, 8 Oct 2001 17:32:51 +0200
Received: from 62.225.101.66 ( [62.225.101.66])
	as user jan@mail.wg.de by jan.dip.ammma.net with HTTP;
	Mon,  8 Oct 2001 17:32:49 +0200
Message-ID: <1002555169.3bc1c721cdd66@jan.dip.ammma.net>
Date: Mon,  8 Oct 2001 17:32:49 +0200
From: Jan Schneider <jan@horde.org>
To: doc@lists.horde.org
References: <1002533455.3bc1724fd79a4@linux.wg.de> <20011008095901.A10890@csh.rit.edu> <1002551329.3bc1b821bcbf4@jan.dip.ammma.net> <20011008104659.B11444@csh.rit.edu>
In-Reply-To: <20011008104659.B11444@csh.rit.edu>
MIME-Version: 1.0
Content-Type: text/plain
Content-Transfer-Encoding: 8bit
User-Agent: Internet Messaging Program (IMP) 2.3.7-cvs
X-Sender: 320034214675-0001@t-dialin.net
Subject: Re: [doc] Problems making manual

Ok, I got it.

I installed all necessary stuff from rpms. But the post-install scripts didn't 
set the SGML_CATALOG_FILES environment variable.
Once I set it manually I still get some error messages about the iso 8879:1986 
style sheet but everything is created correctly.

Jan.

Zitat von Jon Parise <jon@horde.org>:

> On Mon, Oct 08, 2001 at 04:28:49PM +0200, Jan Schneider wrote:
> 
> > > > I have problems creating the manual with make or make html. 
> > > > 
> > > > The error messages sound like: 
> > > > /usr/bin/openjade:./html.dsl:1:73:W: cannot generate system identifier
> for
> > > 
> > > > public text "-//James Clark//DTD DSSSL Style Sheet//EN" 
> > > > /usr/bin/openjade:./html.dsl:5:0:E: reference to entity "STYLE-SHEET"
> for
> > > which 
> > > > no system identifier could be generated 
> > > > 
> > > > There are a bunch of more messages that probably depend on the first
> ones.
> > > 
> > > > 
> > > > Installed is openjade, DocBook 4 DTD and the DocBook DSSSL stylesheet
> by
> > > Norman 
> > > > Walsh. 
> > >  
> > > I'm not sure.  I'm using jade 1.2.1 (ftp://ftp.jclark.com/pub/jade/),
> > > and it works fine.
> > 
> > I just gave this jade version a try and get exactly the same error
> messages.
>  
> Strange.  Maybe it has something to do with the stylesheet.  I'm
> using: dsssl-docbook-modular-1.71
> 
> -- 
> Jon Parise (jon@csh.rit.edu)  .  Information Technology (2001)
> http://www.csh.rit.edu/~jon/  :  Computer Science House Member
> 
> -- 
> Doc mailing list: http://docs.horde.org/
> Frequently Asked Questions: http://horde.org/faq/
> To unsubscribe, mail: doc-unsubscribe@lists.horde.org
> 
> 


:::::::::::::::::::::::::::::::::::::::: 
AMMMa AG - discover your knowledge
:::::::::::::::::::::::::::
Detmolder Str. 25-33 :: D-33604 Bielefeld
fon +49.521.96878-0 :: fax  +49.521.96878-20
http://www.ammma.de
::::::::::::::::::::::::::::::::::::::::::::::


>From jan@horde.org Date: Mon,  8 Oct 2001 17:38:38 +0200
Return-Path: <jan@horde.org>
Mailing-List: contact doc-help@lists.horde.org; run by ezmlm
Delivered-To: mailing list doc@lists.horde.org
Received: (qmail 55213 invoked from network); 8 Oct 2001 15:44:25 -0000
Received: from mailout01.sul.t-online.com (HELO mailout01.sul.t-online.de) (194.25.134.80)
  by clark.horde.org with SMTP; 8 Oct 2001 15:44:25 -0000
Received: from fwd04.sul.t-online.de 
	by mailout01.sul.t-online.de with smtp 
	id 15qcZs-0001tV-05; Mon, 08 Oct 2001 17:44:24 +0200
Received: from linux.wg.de (320034214675-0001@[217.0.157.79]) by fmrl04.sul.t-online.com
	with esmtp id 15qcZp-0yz0TYC; Mon, 8 Oct 2001 17:44:21 +0200
Received: from localhost (localhost [127.0.0.1])
	by linux.wg.de (8.11.0/8.11.0/SuSE Linux 8.11.0-0.4) with ESMTP id f98Fccc19196
	for <doc@lists.horde.org>; Mon, 8 Oct 2001 17:38:38 +0200
Received: from 62.225.101.66 ( [62.225.101.66])
	as user jan@mail.wg.de by jan.dip.ammma.net with HTTP;
	Mon,  8 Oct 2001 17:38:38 +0200
Message-ID: <1002555518.3bc1c87e36785@jan.dip.ammma.net>
Date: Mon,  8 Oct 2001 17:38:38 +0200
From: Jan Schneider <jan@horde.org>
To: doc@lists.horde.org
MIME-Version: 1.0
Content-Type: text/plain
Content-Transfer-Encoding: 8bit
User-Agent: Internet Messaging Program (IMP) 2.3.7-cvs
X-Sender: 320034214675-0001@t-dialin.net
Subject: translations

Is there a neat way to handle the translations?
Any chance to merge already done translations with updated originals?

I think it will become an annoying task to start translation now when there's 
still so much more documentation to come.

Jan.

:::::::::::::::::::::::::::::::::::::::: 
AMMMa AG - discover your knowledge
:::::::::::::::::::::::::::
Detmolder Str. 25-33 :: D-33604 Bielefeld
fon +49.521.96878-0 :: fax  +49.521.96878-20
http://www.ammma.de
::::::::::::::::::::::::::::::::::::::::::::::


>From zrahman@partex.net Date: Tue,  9 Oct 2001 09:14:57 +0000
Return-Path: <zrahman@partex.net>
Mailing-List: contact doc-help@lists.horde.org; run by ezmlm
Delivered-To: mailing list doc@lists.horde.org
Received: (qmail 92573 invoked from network); 9 Oct 2001 09:11:21 -0000
Received: from partex.net (HELO mail.partex.net) (root@202.4.96.10)
  by clark.horde.org with SMTP; 9 Oct 2001 09:11:21 -0000
Received: (from www@localhost)
	by mail.partex.net (8.9.3/8.9.3) id PAA02217
	for doc@lists.horde.org; Tue, 9 Oct 2001 15:14:57 +0600
From: M Z Rahman <zrahman@partex.net>
X-Authentication-Warning: mail.partex.net: www set sender to zrahman@partex.net using -f
Received: from 202.4.96.28 ( [202.4.96.28])
	as user zrahman@mail.partex.net by mail.partex.net with HTTP;
	Tue,  9 Oct 2001 09:14:57 +0000
Message-ID: <1002618897.3bc2c011b5d36@mail.partex.net>
Date: Tue,  9 Oct 2001 09:14:57 +0000
To: doc@lists.horde.org
MIME-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 8bit
User-Agent: Internet Messaging Program (IMP) 2.3.7-cvs
X-Originating-IP: 202.4.96.28
X-Webmail-Company: Dhakacom Limited.
Subject: Re: [doc] NSTALL document and wvHtml installation.

Okay, here are the other documentation fix for the Horde INSTALL document:

1. In the PHP Extentions header mcrypt link:

mcrypt - http://mcrypt.hellug.gr/

2. Mcrypt installation:

mcrypt
------

Note: get the Libmcrypt library (libmcrypt-2.4.17.tar.gz)from
ftp://mcrypt.hellug.gr/pub/mcrypt/libmcrypt, not the Mcrypt.

"cd to the directory containing your source files: cd..

Untar the libmcrypt source: tar -zxvf libmcrypt*

"cd" to the libmcrypt directory: cd libmcrypt*

Type the following:

./configure
make
make install


3. While configuring PHP4 from the CVS, if the libtool version is less then 1.4
then it will generate an error. A note can specified in the PHP4 installation
section, mentioning to install the latest libtool (at least, libtool-1.4.2).

-----this can be added-----
Note: if you have older than version 1.4 of libtool then, please upgrade the
libtool before you can proceed to configuring PHP4. Libtool can be grabbed from
http://www.gnu.org/software/libtool/libtool.html. After installing thelibtool,
besure copy the "ltconfig" file to your PHP4 src directory from
/usr/share/libtool (if you installed libtool with default settings) directory.
PHP4 complains about the "ltconfig" file if it is not in the current directory.
----Note finishes here-----

4. With the mcrypt configured and installed, the confugre command for PHP4 will be:

./configure --with-zlib --with-mm --with-mysql=/usr/local/mysql \
--with-mcal=../libmcal --with-ldap --with-imap=../imap \
--with-gettext --enable-ftp --with-db3=/usr/local/BerkeleyDB.3.1 \
--with-apache=../apache --with-mcrypt=../libmcrypt-1.4.2 

5. PHP4 CVS version has a broken line in the configure script at 59514. So,
while configuring it just gives an error and gets out. It is nothing but a echo
line, and can be avoided by just putting a remark "#" in from of the line and
the lines following. The note is specified below: (by the way, this is not a
solutions, this is just a quick hack to get the PHP4 work for horde)

----Note for broken line----
Note: if configure script exits giving a error message "./configure: syntax
error near unexpected token `_LT_AC_TRY_DLOPEN_SELF('" then you can aplly the
following diff or you can just comment out the line 59514 to line 59521. 

Diff for the config file:
59514,59521c59514,59521
< _LT_AC_TRY_DLOPEN_SELF(
<   AC_MSG_RESULT(no)
< ,
<   AC_MSG_RESULT(yes)
<   AC_DEFINE(DLSYM_NEEDS_UNDERSCORE, 1, [Define if dlsym() requires a
leading underscode in symbol names. ])
< ,
<   AC_MSG_RESULT(no)
< , )
---
> #_LT_AC_TRY_DLOPEN_SELF(
> #  AC_MSG_RESULT(no)
> #,
> #  AC_MSG_RESULT(yes)
> #  AC_DEFINE(DLSYM_NEEDS_UNDERSCORE, 1, [Define if dlsym() requires a
leading underscode in symbol names. ])
> #,
> #  AC_MSG_RESULT(no)
> #, )

-----Note finishs here-----


6. After installing the mod_ssl, while configuring apache, the ./configure
command should be the following for the ssl support as indicated by the mod_ssl
installation:

EAPI_MM=/usr/local \
SSL_BASE=../openssl-<your version> \
--activate-module=src/modules/php4/libphp4.a \
--enable-module=ssl (Leave this line and SSL_BASE line out is you are NOT
installing mod_ssl)



Thats all I could think of so far. If I remember more, I will post it
immediately. By the way, I am preparing the turba INSTALL documentation also, I
hate to see it empty. :) (My turba still is not working, I am stuck at the login
screen problem :)

Regards,

Zia


Quoting Jon Parise <jon@horde.org>:

> On Sun, Oct 07, 2001 at 02:57:35PM +0600, M Z Rahman wrote:
> 
> > I can give more suggestions on the INSTALL document which might help others
> to
> > install it properly. Like the document does not at all talk about the
> mcrypt
> > installation, where as the test.php shows a RED "NO" about mcrypt, which
> is
> > really eye-catching :)
>  
> Go for it. =)
> 
> -- 
> Jon Parise (jon@csh.rit.edu)  .  Information Technology (2001)
> http://www.csh.rit.edu/~jon/  :  Computer Science House Member
> 
> -- 
> Doc mailing list: http://docs.horde.org/
> Frequently Asked Questions: http://horde.org/faq/
> To unsubscribe, mail: doc-unsubscribe@lists.horde.org
>