-
Notifications
You must be signed in to change notification settings - Fork 3
/
yoda.conf
192 lines (141 loc) · 6.96 KB
/
yoda.conf
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
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
####################################################################
#################### optional configuration file ###################
####################################################################
### all settings have hopefully reasonable defaults in yoda,
### but can be changed here to more suitable settings.
### This file can be found in two locations:
###
### $HOME
### yoda directory
###
### $HOME will be seached first. To protect changes to configuration
### against overwriting as result of git push, copy this configuration
### file into your home directory.
### default command line, executed if not command line parameters given
### by default, defaults are read and executed from file defaults.
### that file must reside in one of the libdirs[@] directories for
### yoda to be able to find it. Alternatively, specify full path here,
### or write the default launch commands here instead.
# default='from defaults'
### silent or chatty system. Debugging aid,
### any integer other than 0 turns chatty on.
# trace=0
### no way found yet to re-perform a real warm- or coldstart.
### Ctrl-C is therefore unable to abort executing functions.
### return to and proceed with interrupted function (0), exit (1),
### or run coldvector (2). Latter can be assigned by boot. Loading
### library quit set perfect conditions for break=2.
### The function coldvector is pointing to is run on top op the
### interrupted function, thereby increasing call stack depth
### for every pushed Ctrl-C
# break=2
### will errors and ctrl-c empty stack and string stack?
### when using yoda interactively, it can be a nuisance to lose
### stack contents after a typo. clean=0 leaves stacks untouched
### in case of error or ctrl-c. _ has been provided to quickly
### empty stacks manually.
# clean=1
### setting callstack to non-zero instructs error handler to show
### a dump of function names helping to pinpoint where the error
### occured. The number given here determines how many levels deep
### function names are printed. Set to 1 to show only the name of
### the word wherin the error occured.
# callstack=0
####################################################################
########################## editor used #############################
####################################################################
### used for:
### editing word doc files
### editing loaded source/library files
### words fix and review loaded from library
#editor="vi" # editors run in console, not backgrounded
#xeditor="featherpad" # xeditors open window and are backgrounded
#editor="less"
# ----- one setting above should suffice -----
# with this I can keep my version customized with an editor you're
# less likely to use, while not needing a different config.
#
# You're free to remove this section ...
[[ "$HOSTNAME" == "h2" ]] && xeditor="efte"
[[ "$HOSTNAME" == "latitude" ]] && xeditor="efte"
# ..... up to here .....
[[ -n "$editor" ]] && editor() { $editor "$@"; } # used with doc, edit
[[ -n "$xeditor" ]] && {
editor() { $xeditor "$@" & } # used with doc, edit
editor="$xeditor"
}
####################################################################
########################### web viewer ############################
####################################################################
### html file viewer or browser is used for displaying files from
### forth-standard.org - the provided word "standard" can be used
### to open the URL shown in the "about" information.
# webview() { dillo "$1" & }
# webview() { links2 -dump "$1"; }
webview() { firefox "$1" 2> /dev/null & }
####################################################################
################ where to find documentation files ################
####################################################################
### documentation base directory. Set to absolute path. Use $mydir as
### placeholder for directory where yoda resides.
# doc="$mydir/doc"
### used as part of word file names,
### prevents files to go hidden by leading period in word names
# worddoc_prefix="word"
### directory where documentation of words reside in,
### with word file prefix appended.
# worddoc="$doc/words/$worddoc_prefix"
####################################################################
######## where and what to look for when loading libraries #########
####################################################################
### the dependencies file is a record of all "provides:" statements found
### in the library files of the first directory specified above, formated
### such that the file containing source of a word is quickly found.
### Here you specify the location and name of the dependencies file.
# dependencies="$mydir/dependencies"
### possible locations of library files, and those
### included when using "from" from yoda source
### begin with an empty list, as it will already contain defaults
# libdirs=()
### add directory "lib" under dir where yoda resides, if existing
### the first added directory has an extra characteristic: it is
### additionally used for resolving forward references. the word
### "dependencies" scan its contents and that of its subdirectories,
### and created the file "dependencies" from it. Other directories
### in libpath aren't scanned, and are therefore not suited for
### libraries containing forward referencable code.
# [[ -d "$$mydir/lib" ]] && libdirs+=("$mydir/lib")
### add current directory
# libdirs+=("$PWD")
### add directory wherein yoda resides
# libdirs+=("$mydir")
### add a directory with a fixed named path, if existing
# [[ -d "/usr/local/lib/yoda" ]] && libdirs+=("/usr/local/lib/yoda")
### add a directory in your home directory, if existing:
# [[ -d "$HOME/yodalib" ]] && libdirs+=("$HOME/yodalib")
####################################################################
##################### specify arithmetic model #####################
####################################################################
### Can't use 64 bit - bash doesn't know unsigned.
### 63 bit is best I can do for now.
# bits=63
### testing signed/unsigned is easier with small models:
# bits=16
# or with even 8 bits
# bits=8
####################################################################
####################### function names #############################
####################################################################
### This is a prefix of bash function names,
### anything allowed here, as long the used characters
### are acceptable for use in bash function names.
# nameprefix="yoda"
### a unique token will be added to $nameprefix for each
### generated function, along with an underscore character appended
### to $nameprefix. xt must be an integer, and will
### become the first token used. Mostly cosmetic, for displaying
### headers of identical lengths.
### If you expect to define more than 9000 words (unlikely), set it
### to a low 5 digit number. Three digits should generally be sufficient,
### but why bother.
# xt="1000"