Index: www/build.wiki ================================================================== --- www/build.wiki +++ www/build.wiki @@ -33,11 +33,11 @@ released versions of fossil are available from the downloads page. To obtain a development version of fossil, follow these steps:

    -

  1. Point your web browser at +

  2. Point your web browser to http://www.fossil-scm.org/.

  3. Click on the Timeline @@ -48,11 +48,11 @@ link.

  4. Finally, click on one of the "Zip Archive" or "Tarball" links, according to your preference. These link will build a ZIP archive or a gzip-compressed tarball of the -complete source code and download it to your browser. +complete source code and download it to your computer.

Aside: Is it really safe to use an unreleased development version of the Fossil source code?

@@ -66,11 +66,11 @@ repository change that prevent loss-of-work due to bugs. The Fossil [./selfhost.wiki | self-hosting repositories], especially the one at [http://www.fossil-scm.org/fossil], usually run a version of trunk that is less than a week or two old. Look at the bottom -right-hand corner of this screen (to the right of "This page was +left-hand corner of this screen (to the right of "This page was generated in...") to see exactly which version of Fossil is rendering this page. It is always safe to use whatever version of the Fossil code you find running on the main Fossil website.

2.0 Compiling

@@ -106,16 +106,19 @@

  • Unix without running "configure" → if you prefer to avoid running configure, you can also use: make -f Makefile.classic. You may want to make minor edits to Makefile.classic to configure the build for your system. -

  • MinGW/MinGW-w64 → Use the mingw makefile: +

  • MinGW3.x (not 4.0)/MinGW-w64 → Use the mingw makefile: "make -f win/Makefile.mingw". On a Windows box you will need either Cygwin or Msys as build environment. On Cygwin, Linux or Darwin you may want to make minor edits to win/Makefile.mingw to configure the cross-compile environment. +Hint: don't use MinGW-4.0, it will compile but fossil won't work correctly, see +https://www.fossil-scm.org/index.html/tktview/18cff45a4e210430e24c. +

  • MSVC → Use the MSVC makefile. First change to the "win/" subdirectory ("cd win") then run "nmake /f Makefile.msc".

    Alternatively, the batch file "win\buildmsvc.bat" may be used and it will attempt to detect and use the latest installed version of MSVC.

    To enable Index: www/hints.wiki ================================================================== --- www/hints.wiki +++ www/hints.wiki @@ -21,14 +21,16 @@ prior to going off network (for example, on a long plane ride) to make sure you have all the latest content locally. Then run "[/help/all|fossil all push]" when you get back online to upload your changes. - 5. Sub-menu options on Timelines lets you select either 20 or 200 - records. But you can manual edit the "n=" query parameter in the - URL to get any number of records you desire. To see a complete - timeline graph, set n to some ridiculously large value like 10000000. + 5. Sub-menu options on Timelines enable you to display a complete + timeline graph by typing in some ridiculously large value like 10000000 + in the 'max' field box. You can page through the timeline by using the + 'older' link at the top and bottom left of the timeline. You may choose + to display files that were changed and easily diff the current against + the previous version by clicking 'diff'. 6. You can manually add a "c=CHECKIN" query parameter to the timeline URL to get a snapshot of what was going on about the time of some check-in. The "CHECKIN" can be [./checkin_names.wiki | any valid check-in or version name], including Index: www/server.wiki ================================================================== --- www/server.wiki +++ www/server.wiki @@ -53,11 +53,11 @@

    Fossil as an inetd/xinetd or stunnel service

    A Fossil server can be launched on-demand by inetd or xinetd using -the [/help/http|fossil http] command. To launch Fossil from inetd, modify +the [/help/http|fossil http] command. To launch Fossil from inetd, modify your inetd configuration file (typically "/etc/inetd.conf") to contain a line something like this: 

     12345 stream tcp nowait.1000 root /usr/bin/fossil /usr/bin/fossil http /home/fossil/repo.fossil
@@ -69,10 +69,23 @@
 Obviously you will
 need to modify the pathnames for your particular setup.
 The final argument is either the name of the fossil repository to be served,
 or a directory containing multiple repositories.
 
    
+
    
+For systems where the port-specification must be a symbolic name and cannot be 
+numeric, add the desired name and port to /etc/services, e.g.:
+
    
+
    +fossil          12345/tcp  #fossil server
+
    
+
    
+and use the symbolic name ('fossil' in this example) instead of the numeral ('12345') 
+in inetd.conf. For details, see the relevant section in your system's documentation, e.g. 
+the [https://www.freebsd.org/doc/en/books/handbook/network-inetd.html|FreeBSD Handbook] in 
+case you use FreeBSD.
+
    
 
    
 If your system is running xinetd, then the configuration is likely to be
 in the file "/etc/xinetd.conf" or in a subfile of "/etc/xinetd.d".
 An xinetd configuration file will appear like this:
    
 
    
@@ -96,10 +109,14 @@
 In both cases notice that Fossil was launched as root.  This is not required,
 but if it is done, then Fossil will automatically put itself into a chroot
 jail for the user who owns the fossil repository before reading any information
 off of the wire.
 
    
+
    
+Inetd or xinetd must be enabled, and must be (re)started whenever their configuration
+changes - consult your system's documentation for details. 
+
    
 
    
 [https://www.stunnel.org/ | Stunnel version 5] is an inetd-like process that
 accepts and decodes SSL-encrypted connections.  Fossil can be run directly from
 stunnel in a manner similar to inetd and xinetd.  This can be used to provide
 a secure link to a Fossil project.  The configuration needed to get stunnel5