Re: [fossil-users] Contributing to wiki?

2013-01-09 Thread Gilles
On Tue, 08 Jan 2013 15:30:13 +0100, Gilles
gilles.gana...@free.fr wrote:
I'd like to contribute an article in the wiki, but even after logging
as anonymous, I can't see any way to add a new page:

http://www.fossil-scm.org/index.html/wcontent

Are contributions limited to non-anonymous users?

FYI, articles in the wiki are listed several times, each starting with
the next word in its title:


Branching, Forking, Merging, and Tagging
Forking, Merging, and Tagging — Branching,
Merging, and Tagging — Branching, Forking,
Tagging — Branching, Forking, Merging, and

http://www.fossil-scm.org/index.html/doc/trunk/www/permutedindex.wiki

___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users


Re: [fossil-users] Contributing to wiki?

2013-01-09 Thread Stephan Beal
On Wed, Jan 9, 2013 at 2:34 PM, Gilles gilles.gana...@free.fr wrote:

 http://www.fossil-scm.org/index.html/doc/trunk/www/permutedindex.wiki


That one's generated that way on purpose by a program. Notice that
Questions -- Frequently Asked also has 3 variants (Asked Frequently --
Question ...).

-- 
- stephan beal
http://wanderinghorse.net/home/stephan/
http://gplus.to/sgbeal
___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users


[fossil-users] Contributing to wiki?

2013-01-08 Thread Gilles
Hello

I'd like to contribute an article in the wiki, but even after logging
as anonymous, I can't see any way to add a new page:

http://www.fossil-scm.org/index.html/wcontent

Are contributions limited to non-anonymous users?

Thank you.

___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users


Re: [fossil-users] Contributing to wiki?

2013-01-08 Thread Stephan Beal
On Tue, Jan 8, 2013 at 3:30 PM, Gilles gilles.gana...@free.fr wrote:

 I'd like to contribute an article in the wiki, but even after logging
 as anonymous, I can't see any way to add a new page:

 http://www.fossil-scm.org/index.html/wcontent

 Are contributions limited to non-anonymous users?


The wiki in the main repo is not really maintained any longer - the project
generally prefers the embedded docs approach because those docs partake
in the whole versioning/branching mechanism whereas wiki pages are
versioned but there is no UI for going to a specific version of a wiki
page, and they don't participate in branching,

For the time being, feel free to post patches against the files www/*.wiki
here and one of the commiters can get them piped it. The easiest way to
test local changes to those files is...

edit the file you wish and then visit it by starting fossil server or
fossil ui and use this URL: http://localhost:8080/doc/ckout/www/index.wiki

note the path part ckout - that tells fossil to serve the local copy of
that file from your hard drive. As you edit the file, just keep tapping F5
to reload the changes.

-- 
- stephan beal
http://wanderinghorse.net/home/stephan/
http://gplus.to/sgbeal
___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users


Re: [fossil-users] Contributing to wiki?

2013-01-08 Thread Gilles
On Tue, 8 Jan 2013 15:40:25 +0100, Stephan Beal
sgb...@googlemail.com wrote:
The wiki in the main repo is not really maintained any longer - the project
generally prefers the embedded docs approach because those docs partake
in the whole versioning/branching mechanism whereas wiki pages are
versioned but there is no UI for going to a specific version of a wiki
page, and they don't participate in branching,

For the time being, feel free to post patches against the files www/*.wiki
here and one of the commiters can get them piped it. The easiest way to
test local changes to those files is...

edit the file you wish and then visit it by starting fossil server or
fossil ui and use this URL: http://localhost:8080/doc/ckout/www/index.wiki

note the path part ckout - that tells fossil to serve the local copy of
that file from your hard drive. As you edit the file, just keep tapping F5
to reload the changes.

Thanks. I guess that means I must create a new empty repository for
the Fossil source code, synchronizing to fill it with the Fossil
files, add a file in www, commit, and push the changes back to the
official Fossil repository?

___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users


Re: [fossil-users] Contributing to wiki?

2013-01-08 Thread Stephan Beal
On Tue, Jan 8, 2013 at 3:43 PM, Gilles gilles.gana...@free.fr wrote:

 Thanks. I guess that means I must create a new empty repository for
 the Fossil source code, synchronizing to fill it with the Fossil
 files, add a file in www, commit, and push the changes back to the
 official Fossil repository?


Try:

fossil clone http://fossil-scm.org fossil.fsl
mkdir fossil
cd fossil
fossil open ../fossil.fsl
editor_of_choice www/index.wiki 
fossil ui

make some changes in index.wiki, tap F5 in the browser. When you're happy,
do:

[stephan@host:~/cvs/fossil/fossil]$ f diff --unified www/index.wiki
--- www/index.wiki
+++ www/index.wiki
@@ -1,7 +1,8 @@
 titleFossil/title

+BLAH

 p align=center
 font size=3
 iSimple, high-reliability, distributed software configuration
management/i
 /font


then paste that code here on the list (i think the list strips attachments)
or send us a link to it. Before you can get commit access to the main repo
you need to fill out a license waiver and snail-mail it to DRH. i don't
have the link handy, but if you find yourself editing large amounts then we
can fish out the waiver link for you.

@DRH: please correct me if i'm wrong in assuming that documentation patches
do not necessarily need the waiver?

-- 
- stephan beal
http://wanderinghorse.net/home/stephan/
http://gplus.to/sgbeal
___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users


Re: [fossil-users] Contributing to wiki?

2013-01-08 Thread Richard Hipp
On Tue, Jan 8, 2013 at 9:52 AM, Stephan Beal sgb...@googlemail.com wrote:


 @DRH: please correct me if i'm wrong in assuming that documentation
 patches do not necessarily need the waiver?


The Contributor License Agreement (CLA) basically says:  I recognize that
Fossil uses the two-clause BSD license and I hereby release my
changes/patches under that same license.

It would be good to have a CLA online for documentation changes in addition
to code changes, especially if the changes are large.  But I am not nearly
as strict about documentation as I am with code.  Small documentation
changes and/or typo fixes do not require a CLA.  But we would appreciate a
CLA from people who are doing major rewrites.


-- 
D. Richard Hipp
d...@sqlite.org
___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users


Re: [fossil-users] Contributing to wiki?

2013-01-08 Thread Gilles
On Tue, 8 Jan 2013 15:52:59 +0100, Stephan Beal
sgb...@googlemail.com wrote:
then paste that code here on the list (i think the list strips attachments)
or send us a link to it. Before you can get commit access to the main repo
you need to fill out a license waiver and snail-mail it to DRH. i don't
have the link handy, but if you find yourself editing large amounts then we
can fish out the waiver link for you.

Thanks for the tutorial.

Here's the changes made to index.wiki:
www.pastebin.com/raw.php?i=x5X8gFFY

And the little page I wrote in HTML:
www.pastebin.com/raw.php?i=cTpqLd0g

___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users


Re: [fossil-users] Contributing to wiki?

2013-01-08 Thread Stephan Beal
On Tue, Jan 8, 2013 at 4:21 PM, Gilles gilles.gana...@free.fr wrote:

 Here's the changes made to index.wiki:
 www.pastebin.com/raw.php?i=x5X8gFFY

 And the little page I wrote in HTML:
 www.pastebin.com/raw.php?i=cTpqLd0g


That seems to (in spirit, at least) duplicate the Quickstart page:

http://fossil-scm.org/index.html/doc/trunk/www/quickstart.wiki

:-?

One comment/FYI for future reference: the title tag won't work properly
here because Fossil wraps up the wiki content in the body of the page,
whereas the title tag belongs in the header.

-- 
- stephan beal
http://wanderinghorse.net/home/stephan/
http://gplus.to/sgbeal
___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users


Re: [fossil-users] Contributing to wiki?

2013-01-08 Thread Gilles
On Tue, 08 Jan 2013 16:21:33 +0100, Gilles
gilles.gana...@free.fr wrote:
And the little page I wrote in HTML:
www.pastebin.com/raw.php?i=cTpqLd0g

One typo:

Check current status

... This shows the list of changes that have been done and will be
commited the next time you run fossil commit. It's a useful command
to run before running fossil commit just to check that things are OK
BEFOR proceeding.

and one mistake:
Cancel changes and go back to prevision revision

... For security, since the work file hasn't been checked in, Fossil
will prompt you to confirm that you do wish to replace the file.

- Fossil doesn't prompt when reverting a file. It simply reminds the
user of the undo command, just in case it was a mistake.

___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users


Re: [fossil-users] Contributing to wiki?

2013-01-08 Thread Gilles
On Tue, 8 Jan 2013 16:29:44 +0100, Stephan Beal
sgb...@googlemail.com wrote:
That seems to (in spirit, at least) duplicate the Quickstart page:

http://fossil-scm.org/index.html/doc/trunk/www/quickstart.wiki

The problem I had with the Quick Start is:

- it includes commands that are useless/confusing when using Fossil
just as a single user (cloning, importing, push/pull,
branching/merging, server, etc.)

- it doesn't include commands I found useful or didn't provide enough
infos (eg. what rm really does, how to compare two revisions of a
file, etc.)

But it's OK if the Quick Guide is considered good enough. No biggie.

One comment/FYI for future reference: the title tag won't work properly
here because Fossil wraps up the wiki content in the body of the page,
whereas the title tag belongs in the header.

Good to know. Thank you.

___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users


Re: [fossil-users] Contributing to wiki?

2013-01-08 Thread Richard Hipp
On Tue, Jan 8, 2013 at 10:21 AM, Gilles gilles.gana...@free.fr wrote:


 And the little page I wrote in HTML:
 www.pastebin.com/raw.php?i=cTpqLd0g


http://www.fossil-scm.org/fossil/doc/trunk/www/fiveminutes.wiki

-- 
D. Richard Hipp
d...@sqlite.org
___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users


Re: [fossil-users] Contributing to wiki?

2013-01-08 Thread Stephan Beal
On Tue, Jan 8, 2013 at 4:47 PM, Richard Hipp d...@sqlite.org wrote:



 On Tue, Jan 8, 2013 at 10:21 AM, Gilles gilles.gana...@free.fr wrote:


 And the little page I wrote in HTML:
 www.pastebin.com/raw.php?i=cTpqLd0g


 http://www.fossil-scm.org/fossil/doc/trunk/www/fiveminutes.wiki


It seems i was wrong about the TITLE tag being completely ignored - the
wiki uses that as the title.

@Gilles: i'll get your last changes into that file in a few minutes.

-- 
- stephan beal
http://wanderinghorse.net/home/stephan/
http://gplus.to/sgbeal
___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users


Re: [fossil-users] Contributing to wiki?

2013-01-08 Thread Gilles
On Tue, 8 Jan 2013 16:54:54 +0100, Stephan Beal
sgb...@googlemail.com wrote:
 http://www.fossil-scm.org/fossil/doc/trunk/www/fiveminutes.wiki


It seems i was wrong about the TITLE tag being completely ignored - the
wiki uses that as the title.

@Gilles: i'll get your last changes into that file in a few minutes.

Thank you.

___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users


Re: [fossil-users] Contributing to wiki?

2013-01-08 Thread Gilles
On Tue, 8 Jan 2013 16:54:54 +0100, Stephan Beal
sgb...@googlemail.com wrote:
@Gilles: i'll get your last changes into that file in a few minutes.

Oops, I forgot to show the command for Commit changes:

fossil commit -m Added stuff

___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users


Re: [fossil-users] Contributing to wiki?

2013-01-08 Thread Stephan Beal
On Tue, Jan 8, 2013 at 5:27 PM, Gilles gilles.gana...@free.fr wrote:

 On Tue, 8 Jan 2013 16:54:54 +0100, Stephan Beal
 sgb...@googlemail.com wrote:
 @Gilles: i'll get your last changes into that file in a few minutes.

 Oops, I forgot to show the command for Commit changes:

 fossil commit -m Added stuff


Fixed: http://fossil-scm.org/index.html/info/0fb6c829f2

-- 
- stephan beal
http://wanderinghorse.net/home/stephan/
http://gplus.to/sgbeal
___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users


Re: [fossil-users] Contributing to wiki?

2013-01-08 Thread Gilles
On Tue, 8 Jan 2013 17:56:36 +0100, Stephan Beal
sgb...@googlemail.com wrote:
 Oops, I forgot to show the command for Commit changes:

 fossil commit -m Added stuff


Fixed: http://fossil-scm.org/index.html/info/0fb6c829f2

Thanks Stephan.

___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users