Re: Browsing the source

[Yury V. Zaytsev]

On Sun, 2016-02-21 at 19:19 +0200, Mooffie wrote:
> 
> - GLOBAL ignores dot-files and dot-directories, so you can install it
> in ".global" instead of "CVS".
> 
> - Right now the header on the front page (index.html) is "mc". We can
> change it by running htags thus:

Thanks, good catches!

> (BTW, it's possible to tell htags to make the front page (index.html)
> show all the files in a collapsible JavaScript tree (by adding the
> option `--tree-view=filetree`). But this makes the front page 96K
> instead of just 13K and the browser will also download an uncompressed
> jquery.js (161K) so I don't know if we should enable this feature.)

I don't have a strong opinion on this to be honest... let's say I'm
something like -0 on enabling this.

> > If that looks fine to you, maybe we should put it somewhere on the
> Trac,
> 
> Put what on Trac? A link to http://source.mc.org? Sure.
> 
> We also need to add to the front page of http://source.mc.org a short
> introductory text pointing to the main site (and to the instructions
> for producing the HTML on one's own computer). Leave it to me: I'll
> investigate this and provide a patch in a couple of days.

Ok, great!

-- 
Sincerely yours,
Yury V. Zaytsev


___
mc-devel mailing list
https://mail.gnome.org/mailman/listinfo/mc-devel

Re: Browsing the source

[Mooffie]

On 2/19/16, Yury V. Zaytsev  wrote:
> [...] I've finished the integration
> script and the results are available at the following URL:
>
>  http://source.midnight-commander.org

Superb! Thanks!

minor comments:

- GLOBAL ignores dot-files and dot-directories, so you can install it
in ".global" instead of "CVS".

- Right now the header on the front page (index.html) is "mc". We can
change it by running htags thus:

htags --suggest -t "Welcome to the Midnight Commander source tour!"


(BTW, it's possible to tell htags to make the front page (index.html)
show all the files in a collapsible JavaScript tree (by adding the
option `--tree-view=filetree`). But this makes the front page 96K
instead of just 13K and the browser will also download an uncompressed
jquery.js (161K) so I don't know if we should enable this feature.)

>
> If that looks fine to you, maybe we should put it somewhere on the Trac,

Put what on Trac? A link to http://source.mc.org? Sure.

We also need to add to the front page of http://source.mc.org a short
introductory text pointing to the main site (and to the instructions
for producing the HTML on one's own computer). Leave it to me: I'll
investigate this and provide a patch in a couple of days.
___
mc-devel mailing list
https://mail.gnome.org/mailman/listinfo/mc-devel

Re: Browsing the source

[Mooffie]

On 2/18/16, Yury V. Zaytsev  wrote:
> I wonder whether you would mind giving `htagsfix` a more permanent home? [...]
> Maybe you could "officially" release and maintain it in a GitHub repository

Done:

https://github.com/mooffie/htagsfix

>
> or even try to get it pushed into GNU Global itself?

We may need additional customizations, so it's better to keep it
independent for a while.

(BTW, my original attempt was to modify htag's code itself, but I
found its C code not very wieldy so I gave up and cobbled up a quick
script.)
___
mc-devel mailing list
https://mail.gnome.org/mailman/listinfo/mc-devel

Re: Browsing the source

[Yury V. Zaytsev]

On Tue, 16 Feb 2016, Mooffie wrote:


Ouch! I created a MarkDown instructions page before I got your reply.
Here it is:

   https://gist.github.com/mooffie/72d58969eceb885febf5

(I'll convert it to MC's wiki sometime.)


I'm trying to get this all to work with Travis & GitHub Pages and I wonder 
whether you would mind giving `htagsfix` a more permanent home?


I'm not entirely happy with hardcoding a path to a random gist from where 
this script can be downloaded into the deployment script. Of course, we 
could include it in our repository, but I don't think that's a good idea 
since it's definitively not mc-specific. Maybe you could "officially" 
release and maintain it in a GitHub repository under your account, which 
sounds a bit more permanent than a gist or even try to get it pushed into 
GNU Global itself?


--
Sincerely yours,
Yury V. Zaytsev

___
mc-devel mailing list
https://mail.gnome.org/mailman/listinfo/mc-devel

Re: Browsing the source

[Mooffie]

> On 2/16/16, Yury V. Zaytsev  wrote:
>> > Global doesn't seem to be available as a package on RHEL though?! :-(
>>
>> http://www.geocities.co.jp/keep_creating/sanaly/index.html

BTW, you need to install just the "global" package. You don't need
"pygments" and "sanaly".

(I use htags to create static HTML pages but it can also produce
alternative output for servers supporting CGI (Perl). I guess "sanaly"
is something similar.)
___
mc-devel mailing list
https://mail.gnome.org/mailman/listinfo/mc-devel

Re: Browsing the source

[Mooffie]

On 2/16/16, Yury V. Zaytsev  wrote:
> On 2/16/16, Mooffie  wrote:
> > If I get write access to MC's wiki I can prepare a page listing the
> > steps to generate this documentation
>
> Done.

Ouch! I created a MarkDown instructions page before I got your reply.
Here it is:

https://gist.github.com/mooffie/72d58969eceb885febf5

(I'll convert it to MC's wiki sometime.)

> Could you please tell how much time is required for generation, I'm
> wondering whether I can simply have it run upon every commit or rather
> it would be more appropriate to let it run hourly / nightly or so.

As the instructions page explains, there are three commands to run
(gtags, htags, htagsfix). On my computer it takes about 3 minutes
total. But I'm using an old Pentium 4. I imagine modern computers do
this in at least 20% of the time: 35 seconds top.

> > Global doesn't seem to be available as a package on RHEL though?! :-(
>
> http://www.geocities.co.jp/keep_creating/sanaly/index.html

I see that this is the newest 'global' version. Good. You can ignore
the "appendix" on the instructions page.

> > We can also provide a downloadable tarball
> > (around 12 MB) so people can have it right away.

Anybody who's interested can download the HTML archive here:

http://www.typo.co.il/~mooffie/tmp/mc/mc-source-html.PASSWORD.tgz

Replace "PASSWORD" with "bird" (sorry for this silly trick. I don't
want people to stress the server).
___
mc-devel mailing list
https://mail.gnome.org/mailman/listinfo/mc-devel

Re: Browsing the source

[Yury V. Zaytsev]

On Tue, 16 Feb 2016, Yury V. Zaytsev wrote:

I can put it on http://midnight-commander.org/global or whatever would be the 
most appropriate URL if you can explain how to generate it.


Could you please tell how much time is required for generation, I'm wondering 
whether I can simply have it run upon every commit or rather it would be more 
appropriate to let it run hourly / nightly or so.


Current plan: write a shell script & commit to the repository. Set up a 
cron job on m-c.o to fetch, hard reset to each remote branch, and generate 
an index. Set up nginx to serve the directory.


Alternative possibility: generate indices on Travis for every commit it 
builds, deploy to Github pages? Advantages: one service less on the 
project infra. Problem 1: Travis only has global 5.7.1, is there an Ubuntu 
PPA with a newer version? Problem 2: need to be smart about branches, more 
complicated script, looks like it will take more time to get to work.



Global doesn't seem to be available as a package on RHEL though?! :-(


http://www.geocities.co.jp/keep_creating/sanaly/index.html

Re. wiki editing privileges, I can grant them as soon as I get access to my 
admin account.


Done.

--
Sincerely yours,
Yury V. Zaytsev

___
mc-devel mailing list
https://mail.gnome.org/mailman/listinfo/mc-devel