Fossil Forum

[how to] get fossil-scm running on termux
Login

[how to] get fossil-scm running on termux

[how to] get fossil-scm running on termux

(1.5) By aue oiae (cregox) on 2020-12-15 14:19:13 edited from 1.4 [link] [source]

perhaps this could become a "quicker start" guide, eventually?

i would make this into a wiki, but no idea how. and there's already a quick start guide... it's so big i gave up on trying it, at first. 😆😣

  1. get an android. no links here, this should be oblivious enough. 😏

  2. install termux. it's this uniquely awesome linux shell for android.

  3. pkg install fossil + there might be more commands needed around this

  4. USER=<your user name> ; echo \$USER=$USER >> ~/.bashrc (or $USER="<your user name>" ; echo @("$USER = '"+$USER+"'") >> ~/.xonshrc if you also decided to use xonsh for your shell) + fossil needs a user and termux doesn't offer it by default. this step is only necessary once! keep in mind there are other ways to set the user for fossil.

  5. you might want to see an estimated repo size before trying to clone it on the stat page. so you'll be less intimidated in trying the next step... TK how to see the repo size using fossil command?

  6. fossil clone https://fossil-scm.org fossil-crm.fossil + it could be any other filename of your choice rather than fossil-crm.fossil it took me less than 5 minutes to download the 52mb in my crappy connection, but your mileage may vary a lot. if it falls, just execute again:

    redirect with status 301 to https://www.fossil-scm.org/home
    Round-trips: 8   Artifacts sent: 0  received: 49958
    Clone done, sent: 2442  received: 34722213  ip: 45.33.6.223
    Rebuilding repository meta-data...
    100.1% complete...
    Extra delta compression...
    Vacuuming the database...
    project-id: CE59BB9F186226D80E49D1FA2DB29F935CCA0333
    server-id:  16fa8e8908933b1439a0dae00fed9ccca114327e
    admin-user: cregox (password is "XVUcKnlhFJ")
    

  7. mkdir scm + again, use any name you want.

  8. cd scm + by default, fossil should be opened in an empty folder.

  9. fossil open ../fossil-scm.fossil + took me less than 5 seconds to get to the bottom of it, in my cheap android:

    project-name: Fossil
    repository:   /data/data/com.termux/files/home/old/fossil/fossil-scm/../fossil-scm.fossil
    local-root:   /data/data/com.termux/files/home/old/fossil/fossil-scm/
    config-db:    /data/data/com.termux/files/home/.config/fossil.db
    project-code: CE59BB9F186226D80E49D1FA2DB29F935CCA0333
    checkout:     358d7d8f0ee8e53c6f8c5b655725164ead12ad03 2020-12-13 19:37:35 UTC
    parent:       fc300d5a9aaeb54745fc466492948611d63439bf 2020-12-13 05:32:58 UTC
    tags:         trunk
    comment:      Updates to the fossil-v-git documentation
              to reduce the amount of Git-bashing and
              to try to make the document less
              confrontational. (user: drh)
    check-ins:    14943
    ➜ fossil-scm  ls
    BUILD.txt            VERSION    debian         test
    COPYRIGHT-BSD2.txt   ajax       fossil.1       tools
    Dockerfile           art        manifest       win
    Makefile.classic     auto.def   manifest.uuid  www
    Makefile.in          autosetup  setup
    Makefile.osx-jaguar  compat     skins
    README.md            configure  src
    

  10. fossil up + it gives admin, while server doesn't. on termux it doesn't automatically open the browser, for some reason. just go to http://localhost:8080/doc/trunk/www/quickstart.wiki or something.

  11. search is disabled by default. go on the browser, admin, search, and set it up there: http://localhost:8080/srchsetup

  12. finally, to clone the forums: fossil clone https://www.fossil-scm.org/forum fossil-scm-forum.fossil it was around 14M in my case. follow same steps as before to open it in a similar folder. it can be started alongside on a different port, automatically assigned by fossil.

there's perhaps just one more big detail i couldn't figure out yet: how to make the search the same quality as online. any help?

(2) By Stephan Beal (stephan) on 2020-12-14 16:28:21 in reply to 1.0 [link] [source]

$USER=<your user name>

That should be:

USER=...

Only use a dollar sign prefix when dereferencing/expanding the variable, not when setting it.

fossil clone https://fossil-scm.org fossil-crm.sql

i strongly recommend against using an extension of "sql" because that extension might get associated with some arbitrary text editor on your system (for opening SQL (text) files), and it would be Bad Idea to open a fossil repo in a text editor. The conventional extension is ".fossil", but it can really be anything you want it to be.

TK how to also clone the forums?

fossil clone https://fossil-scm.org/forum forum.fossil

(4.2) By aue oiae (cregox) on 2020-12-15 10:26:02 edited from 4.1 in reply to 2 [link] [source]

for the first time in over an year i had an annoying loss of data using one app i was used to use for preventing losing data on filling up online forms such as this... and that .sql there is a artifact from this issue. i had removed it, never intended to publish it... although now i'm kind of glad i did. knowing the default was .fossil already hinted me it would be bad, just not this bad! thanks for the recommendation. 😘

the variable is much more complex, though... bash supports your idea. i was testing it in xonsh, and both work fine there but only $USER= works with fossil. more importantly, i should have said it will be a temporary solution and, as such, a rather bad one both for my will and for such a small guide.

given how good the history log is here, i'll just edit the first post to reflect your advices.

and eventually i may even learn to pay more attention to the preview before submitting...

why are the forums separated like that, from fossil clone?

(3) By sean (jungleboogie) on 2020-12-14 16:29:55 in reply to 1.0 [link] [source]

Never heard of termux. Cna you provide a link to the project page?

(5) By Daniel Dumitriu (danield) on 2020-12-14 17:11:36 in reply to 3 [link] [source]

Termux. It's nice. I can even compile Fossil (clang) and test my patches. (For fossil ui it seems to be needing a larger port number, but those are probably just Android's intricacies.)

(6.1) By aue oiae (cregox) on 2020-12-14 17:33:14 edited from 6.0 in reply to 5 [link] [source]

indeed. you can only access some ports with a rooted android.

(7) By aue oiae (cregox) on 2020-12-27 15:43:38 in reply to 1.5 [link] [source]

still missing 2 big aspects here:

  • the forum clone doesn't get that beautiful thread view without the editions.

  • i would like the search (and the forums) added to the top, like it's done on sqlite. but i can't even seen to clone it and see how it's done...

any hints for either case? 😁

(8) By Stephan Beal (stephan) on 2020-12-27 16:46:40 in reply to 7 [source]

i would like the search (and the forums) added to the top, like it's done on sqlite. but i can't even seen to clone it and see how it's done...

$ fossil clone https://sqlite.org/forum sf.fossil
Round-trips: 2   Artifacts sent: 0  received: 7501
Clone done, sent: 523  received: 4772465  ip: 45.33.6.223
...

$ fossil ui sf.fossil

Go to Admin ==> Search. Near the bottom, click the "Search Forum" checkbox, then "Apply Changes", then the "Threads" link at the top of the page. The search input field will then appear.

To pull the latest threads from the forum:

fossil pull -R sf.fossil 
Pull from https://sqlite.org/forum
Round-trips: 1   Artifacts sent: 0  received: 0
...

(9) By aue oiae (cregox) on 2020-12-27 19:17:03 in reply to 8 [link] [source]

sorry for the confusion. and thanks for so fast reply!

i meant the search like in sqlite.org only. where it says "home menu search". and then later also adding a forum link to the top of my own fossil. sqlite.org is the one i can't seen to clone. don't care about its forum...

forum from fossil already offers search on the first page, so from my perspective the sqlite forum is worse! 🤣

(10) By Stephan Beal (stephan) on 2020-12-27 21:29:17 in reply to 9 [link] [source]

meant the search like in sqlite.org only.

If it's not an option in the Admin => Search set than i have no idea.

sqlite.org is the one i can't seen to clone.

fossil clone https://sqlite.org/src sqlite.fossil

They have a separate repo for their doc tools:

fossil clone https://sqlite.org/docsrc sqlitedoc.fossil