/usr/share/doc/garlic-doc/commands/ref.html is in garlic-doc 1.6-1.1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 | <html>
<head>
<title>
REF, REFRESH
</title>
</head>
<h1 align=center>
REF, REFRESH
</h1>
<hr size="3">
<font color=#880000>
<b>
NAME
<br>
</b>
</font>
REF, REFRESH - switch refreshing on or off.
<br><br>
<font color=#880000>
<b>
SYNOPSIS
<br>
</b>
</font>
REF
<br>
REFRESH
<br>
REF OFF
<br>
REFRESH OFF
<br><br>
<font color=#880000>
<b>
DESCRIPTION
<br>
</b>
</font>
Most of garlic commands require redrawing of the main window. This may slow
down the execution of the program. To save some time, the refreshing may be
switched off. Just execute the command:
<br><br>
ref off
<br><br>
(the long form is REFRESH OFF). After that, a number of time-consuming
commands may be executed, and refreshing may be turned on again.
To switch on refreshing, execute the command REF without the keyword OFF:
<br><br>
ref
<br><br>
This trick is very useful with scripts. Put the command REF OFF close to the
top of the script and do not forget to put the command REF (without the
keyword OFF!) to the bottom of the script. Try the sample scripts
<a href="http://garlic.mefos.hr/garlic-1.6/tutorial/script1.html">
atoms.script
</a>
,
<a href="http://garlic.mefos.hr/garlic-1.6/tutorial/script2.html">
bonds.script
</a>
and
<a href="http://garlic.mefos.hr/garlic-1.6/tutorial/script3.html">
colors.script
</a>
. The refreshing trick is used in these scripts.
<br><br>
If refreshing is switched off, you will see the message in the middle of the
main garlic window (yellow text "Refreshing off" on red background).
<br><br>
<img src="ref_off.gif">
<br><br>
<hr size="3">
</html>
|