X-Git-Url: http://scm.dxcluster.org/gitweb/gitweb.cgi?a=blobdiff_plain;ds=sidebyside;f=sgml%2FspiderFAQ_en.sgml;h=4e93d269271d54b5ffa4b9da361e6d0e916ca83c;hb=a2823c8abe3c39bbe9dcd30bbe3adfb6d75f9ad4;hp=2ebda13e0951d36885ce06ae551858aa16205cbd;hpb=0fcb7df9b5f6b17605f07d965e71d8bc4dee09a0;p=spider.git diff --git a/sgml/spiderFAQ_en.sgml b/sgml/spiderFAQ_en.sgml index 2ebda13e..4e93d269 100644 --- a/sgml/spiderFAQ_en.sgml +++ b/sgml/spiderFAQ_en.sgml @@ -6,7 +6,7 @@
The tarballs are designed to not overwrite your existing configuration
and can be used at any time to update your Spider software. All the key
-files have the suffix .issue (eg. DXVars.pm.issue) at default.
+files have the suffix .issue (eg. DXVars.pm.issue) at default.
+Please check the time on your PC.
+
+
+All spots are checked that they are no more
+than 15 minutes in the future and 60 minutes in the past. If your clock on your client
+prompt (or console.pl display) is not set to the correct time
+in GMT (UTC) and is more than one hour out (say on your local (summer) time) then
+the test will fail and no spots will come out. Neither will they be stored.
+
+
+If you are connected to the internet, most linux distributions have an implementation of
+
+Whenever you update from CVS, a log is displayed. Next to each
+file that is downloaded there is a letter, e.g.:
+
+
+For normal CVS use you should only ever see the letters 'P', 'U' or '?'. The
+letter 'P' means that the file has
+changed in CVS and is more recent than the one that is currently on your system. You will also
+see the letter '?', which means that
+there is a file that you (or the system) has created that CVS doesn't know about and isn't
+under its control. These are all normal and good.
+
+
+Sometimes you will see the letter 'U' next to a file. This means that it is a new file that you don't currently
+have. This is also OK.
+
+
+However, if you see the letter 'C' or 'M', that means that CVS thinks that the file has
+changed locally. For the letter 'C', it has changed sufficiently near to one or more
+modifications which CVS wants to download to your system. For the 'M', CVS thinks that it
+is OK to make the change (you may also see some messages about "merging revision 1.xx with 1.yy").
+Neither of these things are good. Files that are under the control of CVS
+must not be changed by sysops. It is the files that have the 'C' next to them that will show
+the errors that you are complaining about and they will be things like:-
+
+
+You will not necessarily see all of the errors shown but you will get one or more sets of some
+of them. The cure is simple:
+
+
+You will see that file come back (with a letter 'U' next to it). That will be the correct
+file as CVS thinks it should be. If you still have a problem, then get onto the
+dxspider-support mailing list.
+
+
+If all else fails (or you have several conflicts) you can safely remove the entire /spider/perl and
+/spider/cmd directories and then run the cvs update. They will all be recreated in their pristine
+condition.
+
+
+The correct way to run cvs is:-
+
+
+The '-d' is crucial. It makes sure that any new directories, that may contain new code,
+are created and that new code downloaded. I have absolutely no idea why this is not the
+default, seeing as CVS (in other circumstances) happily recurses its merry way down a
+directory tree, but there you are.
+
+
+WinCVS and other graphical CVS frontends have a checkbox for the update screen called something
+like "create sub-directories" (it may be hidden in some sub-screen - go look for it if it isn't
+obvious). Make sure that this box is checked. If you can make this the
+default setting in the program's setup screen then please do that. It will save you a lot
+of pulled hair.
+