Debian packages and man page for conkeror

Hi,

As already signaled, I've built Debian packages of
conkeror:

http://noone.org/debian/conkeror_0.9~git080522-1_all.deb

http://noone.org/debian/conkeror-s
pawn-process-helper_0.9~git080522-1_i386.deb
http://noone.org/debian/conkeror-
spawn-process-helper_0.9~git080522-1_amd64.deb

They'll hit the Debian NEW queue probably during the next
days. If
everything goes fine, they should show up in Debian Unstable
after a
while and later also in Debian Testing.

For the conkeror Debian package, I also wrote a man page
about
conkeror. But I think the man page is useful also outside
Debian
package, maybe even as official part of conkeror in the
future. So I
attached it to this mail. Comments and corrections are
welcome!

		Regards, Axel
-- 
Axel Beckert - abedeuxchevaux.org, abenoone.org - http://noone.org/abe/

_______________________________________________
Conkeror mailing list
Conkerormozdev.org
http
s://www.mozdev.org/mailman/listinfo/conkeror

Axel Beckert <abedeuxchevaux.org> writes:

> Hi,
> As already signaled, I've built Debian packages of
conkeror:

> http://noone.org/debian/conkeror_0.9~git080522-1_all.deb

> http://noone.org/debian/conkeror-s
pawn-process-helper_0.9~git080522-1_i386.deb
> http://noone.org/debian/conkeror-
spawn-process-helper_0.9~git080522-1_amd64.deb

> They'll hit the Debian NEW queue probably during the
next days. If
> everything goes fine, they should show up in Debian
Unstable after a
> while and later also in Debian Testing.

> For the conkeror Debian package, I also wrote a man
page about
> conkeror. But I think the man page is useful also
outside Debian
> package, maybe even as official part of conkeror in the
future. So I
> attached it to this mail. Comments and corrections are
welcome!

Thanks for creating a Debian package for Conkeror. 
Hopefully it will
help increase the Conkeror userbase.  After looking over the
package, I
have just a few comments:

1. The conkeror.xulapp file should not be included, as it is
used only
   for a particular method of installing Conkeror, and is
not needed
   after that.
2. The -help command-line option is actually handled by
xulrunner
   itself, and merely displays the canned xulrunner usage
information.
   The -width and -height options advertised are not
actually
   functional, so they should be removed from the man page. 
It would
   not be too hard to create a way to specify an initial
size for a
   window to be opened.  (Many users of Conkeror presumably
use a tiling
   window manager, making the initial size irrelevant,
though.)

-- 
Jeremy Maitin-Shepard
_______________________________________________
Conkeror mailing list
Conkerormozdev.org
http
s://www.mozdev.org/mailman/listinfo/conkeror

Hi,

On Tue, Jun 10, 2008 at 07:18:10PM -0400, Jeremy
Maitin-Shepard wrote:
> Thanks for creating a Debian package for Conkeror. 
Hopefully it will
> help increase the Conkeror userbase.  After looking
over the package, I
> have just a few comments:
> 
> 1. The conkeror.xulapp file should not be included, as
it is used only
>    for a particular method of installing Conkeror, and
is not needed
>    after that.

Already noticed that. This, and some more things of that
kind, are
already fixed in my packaging repository[1] and will be
fixed with the
next release of the package.

  [1] http://noone.org/
hg/conkeror/debian -- I currently use Mercurial
      (hg), but will probably switch to git which can make
things
      easier because conkeror itself uses git.

> 2. The -help command-line option is actually handled by
xulrunner
>    itself, and merely displays the canned xulrunner
usage
>    information.

Seems so, yes.

>    The -width and -height options advertised are not
actually
>    functional,

Noticed that, too. It's a known bug in Mozilla since 2000.
:-(

>    so they should be removed from the man page. 

I will include hints in the --help output as well as the man
page
pointing to the bug reports I posted already to the list.

>    (Many users of Conkeror presumably use a tiling
window manager,
>    making the initial size irrelevant, though.)

Ack.

		Regards, Axel
-- 
Axel Beckert - abedeuxchevaux.org, abenoone.org - http://noone.org/abe/
_______________________________________________
Conkeror mailing list
Conkerormozdev.org
http
s://www.mozdev.org/mailman/listinfo/conkeror

Axel Beckert <abedeuxchevaux.org> writes:

> Hi,
> On Tue, Jun 10, 2008 at 07:18:10PM -0400, Jeremy
Maitin-Shepard wrote:
>> Thanks for creating a Debian package for Conkeror. 
Hopefully it will
>> help increase the Conkeror userbase.  After looking
over the package, I
>> have just a few comments:
>> 
>> 1. The conkeror.xulapp file should not be included,
as it is used only
>> for a particular method of installing Conkeror, and
is not needed
>> after that.

> Already noticed that. This, and some more things of
that kind, are
> already fixed in my packaging repository[1] and will be
fixed with the
> next release of the package.

>   [1] http://noone.org/
hg/conkeror/debian -- I currently use Mercurial
>       (hg), but will probably switch to git which can
make things
>       easier because conkeror itself uses git.

It might be slightly easier if you used included the
conkeror repository
in your packaging repository via git submodules, or
alternatively used
the subtree merge strategy.

As far as I understand (I've never used them myself),
submodules should
do exactly what you need, but their use is somewhat
complicated.

>> 2. The -help command-line option is actually
handled by xulrunner
>> itself, and merely displays the canned xulrunner
usage
>> information.

> Seems so, yes.

>> The -width and -height options advertised are not
actually
>> functional,

> Noticed that, too. It's a known bug in Mozilla since
2000. :-(

>> so they should be removed from the man page. 

> I will include hints in the --help output as well as
the man page
> pointing to the bug reports I posted already to the
list.

The only bug, though, is that the options are listed in the
--help
output.  There isn't anything in Mozilla that could be fixed
to support
those options --- Conkeror itself would need to handle them
and do
something with them.

One other suggestion I have is that you include somewhere in
the package
the commit name (hash) of the version of Conkeror that is
incorporated,
so that in the case of bug reports it is easier to know
exactly what
version the user has.  Possibly a place to include it would
be
application.ini, setting BuildID to the actual commit name
instead of
the string "git".  (This is done automatically by
the build.sh script in
preparing the xulapp file, but your Debian package doesn't
make use of
the xulapp files.)

-- 
Jeremy Maitin-Shepard
_______________________________________________
Conkeror mailing list
Conkerormozdev.org
http
s://www.mozdev.org/mailman/listinfo/conkeror

Hi,

On Wed, Jun 11, 2008 at 08:21:54AM -0400, Jeremy
Maitin-Shepard wrote:
> >   [1] http://noone.org/
hg/conkeror/debian -- I currently use Mercurial
> >       (hg), but will probably switch to git which
can make things
> >       easier because conkeror itself uses git.
> 
> It might be slightly easier if you used included the
conkeror repository
> in your packaging repository via git submodules, or
alternatively used
> the subtree merge strategy.

I plan to use git-buildpackage which takes care of the
combination of
upstream and packaging repositories.

> >> The -width and -height options advertised are
not actually
> >> functional,
> 
> > Noticed that, too. It's a known bug in Mozilla
since 2000. :-(
> 
> >> so they should be removed from the man page. 
> 
> > I will include hints in the --help output as well
as the man page
> > pointing to the bug reports I posted already to
the list.
> 
> The only bug, though, is that the options are listed in
the --help
> output.  There isn't anything in Mozilla that could be
fixed to support
> those options

Ok.

> Conkeror itself would need to handle them and do
something with
> them.

Will it?

Anyway, I can make them disappear completely in the wrapper
until
Conkeror supports them.

> One other suggestion I have is that you include
somewhere in the
> package the commit name (hash) of the version of
Conkeror that is
> incorporated, so that in the case of bug reports it is
easier to
> know exactly what version the user has. Possibly a
place to include
> it would be application.ini, setting BuildID to the
actual commit
> name instead of the string "git". (This is
done automatically by the
> build.sh script in preparing the xulapp file, but your
Debian
> package doesn't make use of the xulapp files.)

Good idea. I currently see two possibilities: Either package
version
(which would look very ugly, e.g.
"0.9~git080522-abcdef0123456789"[2],
but visible in bug reports) and changelog, which would be
more decent,
but less obvious. I'll think about it.

  [2] Can't take the commit hash solely since I need a
always
      increasing version name.

BTW: Conkeror itself reports version 0.9 with -version.
What's
actually the idea behind this? I see three possible
interpretations:

+ 0.9 means "not yet 1.0", but there will never be
a 0.9 release
  ("just snapshots" or "0.9 means it's a
snapshot")

+ The project works towards a 0.9 release ("pre-0.9
snapshots")

+ The last release which has been made (not publically, if
so) was 0.9
  ("0.9 plus snapshots").

>From what I know about the project, I guess it's
"just snapshots", no
0.9 release neither in the past nor a planned 0.9 release in
the
future (yet).

Thanks for all the feedback!

		Regards, Axel
-- 
Axel Beckert - abedeuxchevaux.org, abenoone.org - http://noone.org/abe/
_______________________________________________
Conkeror mailing list
Conkerormozdev.org
http
s://www.mozdev.org/mailman/listinfo/conkeror