Re: Re^2: dhelp 0.2 - a online help system

1998-01-05 Thread Karl M. Hegbloom
> "Christian" == Christian Schwarz <[EMAIL PROTECTED]> writes:

Christian> If someone wants to do this with me, just drop me a
Christian> note. I'm just waiting for volunteers...

 I would like to help, but I don't think I've got the skills it would
require right now.  I'll try and take the time to look over what you
people do with it, and learn from your example.  Right now, I really
need to just read books and code, more than anything.


--
TO UNSUBSCRIBE FROM THIS MAILING LIST: e-mail the word "unsubscribe" to
[EMAIL PROTECTED] . 
Trouble?  e-mail to [EMAIL PROTECTED] .



Re: Re^2: dhelp 0.2 - a online help system

1998-01-05 Thread Christian Schwarz
On 5 Jan 1998, Karl M. Hegbloom wrote:

> > "Marco" == Marco Budde <[EMAIL PROTECTED]> writes:
> 
> Marco> We could write a converter :)?
> 
>  I'd rather see a unified interface for that sort of thing than a
> kludgey converter converter scheme.

Once written, doc-base will be the interface for all online
documentations. (Not only registering the manuals to menus, but also
converting between different documentation formats, compressing
documentation, etc.) 

Though we definitely need some time discussing the new documentation
policy we could perhaps start working on the menu registry with doc-base
to get some experience in this area.

If someone wants to do this with me, just drop me a note. I'm just waiting
for volunteers...


Thanks,

Chris

-- Christian Schwarz
[EMAIL PROTECTED], [EMAIL PROTECTED],
Don't know Perl? [EMAIL PROTECTED], [EMAIL PROTECTED]
  
Visit  PGP-fp: 8F 61 EB 6D CF 23 CA D7  34 05 14 5C C8 DC 22 BA
http://www.perl.com http://fatman.mathematik.tu-muenchen.de/~schwarz/


--
TO UNSUBSCRIBE FROM THIS MAILING LIST: e-mail the word "unsubscribe" to
[EMAIL PROTECTED] . 
Trouble?  e-mail to [EMAIL PROTECTED] .



Re: Re^2: dhelp 0.2 - a online help system

1998-01-05 Thread Karl M. Hegbloom
> "Marco" == Marco Budde <[EMAIL PROTECTED]> writes:

Marco> We could write a converter :)?

 I'd rather see a unified interface for that sort of thing than a
kludgey converter converter scheme.


--
TO UNSUBSCRIBE FROM THIS MAILING LIST: e-mail the word "unsubscribe" to
[EMAIL PROTECTED] . 
Trouble?  e-mail to [EMAIL PROTECTED] .



Re: Re^2: dhelp 0.2 - a online help system

1998-01-04 Thread Christian Schwarz
On 4 Jan 1998, Marco Budde wrote:

> Am 03.01.98 schrieb schwarz # monet.m.isar.de ...
> 
> Moin Christian!
> 
> CS> We are aware of this problem. The different menu systems (menu, dwww,
> CS> dhelp, etc.) all have their advantages and disadvantages so I guess they
> CS> will all stay around for a while.
> 
> If you know a disadvantage of dhelp please send me an email. I'm really  
> interessed in good ideas.
> 
> CS> The solution is to provide a unique interface where all packages can
> CS> register their documentation files. This interface programm will than
> CS> support the different menu systems, depending on which are installed. This
> 
> But is that necessary? We could write a simple .dhelp to .dwww converter  
> or dwww can use the /var/lib/dhelp/dbase database. That's no problem. I  
> think, we should use this help system in Debian 2.0. Some other  
> distributions already use such systems (for example SuSE).

You should probably not refer to SUSE here. They are know for their quick
and _dirty_ solutions ;-) 

> I've added dhelp support in debstd last night. It's really no problem to  
> add dhelp support to your packages.

Please don't get me wrong. I have nothing against packages supporting
dhelp. However, dhelp is not our "official" system by now (nor is dwww) so
we can't force everyone to use it by policy.

> CS> I'm currently working on a draft for this interface. It looks like we're
> CS> going to implement that together with a new "Documentation Policy" for
> CS> Debian 2.1.
> 
> Why should we develop another system? We have a working system: dhelp. If  
> we need new features, I can add them.

We need another system anyways to convert between different documentation
formats on demand. Since every online documentation has to be registered
to that system, we shouldn't we do the "menu" registration through the
same system? Everything else looks like doing the same work a few times...

I promise that we'll start discussing and implement the new doc-policy
and all this when "hamm" is out of the door.


Thanks,

Chris

--  Christian Schwarz
 [EMAIL PROTECTED], [EMAIL PROTECTED],
Debian has a logo![EMAIL PROTECTED], [EMAIL PROTECTED]

Check out the logo PGP-fp: 8F 61 EB 6D CF 23 CA D7  34 05 14 5C C8 DC 22 BA
pages at  http://fatman.mathematik.tu-muenchen.de/~schwarz/debian-logo/


--
TO UNSUBSCRIBE FROM THIS MAILING LIST: e-mail the word "unsubscribe" to
[EMAIL PROTECTED] . 
Trouble?  e-mail to [EMAIL PROTECTED] .



Re^2: dhelp 0.2 - a online help system

1998-01-04 Thread Marco Budde
Am 03.01.98 schrieb schwarz # monet.m.isar.de ...

Moin Christian!

CS> We are aware of this problem. The different menu systems (menu, dwww,
CS> dhelp, etc.) all have their advantages and disadvantages so I guess they
CS> will all stay around for a while.

If you know a disadvantage of dhelp please send me an email. I'm really  
interessed in good ideas.

CS> The solution is to provide a unique interface where all packages can
CS> register their documentation files. This interface programm will than
CS> support the different menu systems, depending on which are installed. This

But is that necessary? We could write a simple .dhelp to .dwww converter  
or dwww can use the /var/lib/dhelp/dbase database. That's no problem. I  
think, we should use this help system in Debian 2.0. Some other  
distributions already use such systems (for example SuSE).

I've added dhelp support in debstd last night. It's really no problem to  
add dhelp support to your packages.

CS> I'm currently working on a draft for this interface. It looks like we're
CS> going to implement that together with a new "Documentation Policy" for
CS> Debian 2.1.

Why should we develop another system? We have a working system: dhelp. If  
we need new features, I can add them.

cu, Marco

--
Uni: [EMAIL PROTECTED]  Fido: 2:240/5202.15
Mailbox: [EMAIL PROTECTED]http://www.tu-harburg.de/~semb2204/


--
TO UNSUBSCRIBE FROM THIS MAILING LIST: e-mail the word "unsubscribe" to
[EMAIL PROTECTED] . 
Trouble?  e-mail to [EMAIL PROTECTED] .



Re^2: dhelp 0.2 - a online help system

1998-01-02 Thread Marco Budde
Am 01.01.98 schrieb fog # perosa.alpcom.it ...

Moin [EMAIL PROTECTED]

f> I like it but...

Fine :).

f> 1) How about dwww? (Yes, I know dwww needs a web server...)

On my notebook dwww is very slow when your're accessing documents. And  
building the index produces a very high load on this system. Third the  
index of dwww is never uptodate.

f> 3) The policy says the preferred doc format is HTML (fine) but
f> it says nothing about how to access it. Any ideas before we poor
f> developer have to write a dozen of different conf files to support
f> all that new help systems? (menu entries, .dwww-index, .dhelp, etc...)

We could write a converter :)? I would suggest that we add dhelp and dwww  
support to the debstd tool.

cu, Marco

--
Uni: [EMAIL PROTECTED]  Fido: 2:240/5202.15
Mailbox: [EMAIL PROTECTED]http://www.tu-harburg.de/~semb2204/


--
TO UNSUBSCRIBE FROM THIS MAILING LIST: e-mail the word "unsubscribe" to
[EMAIL PROTECTED] . 
Trouble?  e-mail to [EMAIL PROTECTED] .