tweek 0.9.7 → 0.9.8
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +20 -20
- data/bin/tweek +1 -1
- data/lib/tweek/version.rb +1 -1
- metadata +1 -1
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 11bb16efc38a6fe8434f28a10c2698d8fd4fa1d2
|
4
|
+
data.tar.gz: 25a57e0842c920ee0b3bc30bdad8dbb4920bfe52
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 5286ea3679a4b68e783a16494cecbaa209909c54f6e0853fb23be2bcb49028ce868af43c6989e471f9be77c4ee35caffb971beb116f2e3b7d79252fd90cbd11d
|
7
|
+
data.tar.gz: 7a2ebccd37840451bc6f29d7f82bf6e09b61ec442a80dba631992650c7d365a8f1ddc31d5b68e89a801ad4a57cdb2d8493f5aa0df99664d8f8f68516f5f50302
|
data/README.md
CHANGED
@@ -51,10 +51,10 @@ successful. You should now be able to type `tweek -?` to see the available optio
|
|
51
51
|
|
52
52
|
Tweek can be used in the following modes:
|
53
53
|
|
54
|
-
* To check a default configuration
|
54
|
+
* To check the current system against a default configuration
|
55
55
|
* To create a sample settings file that you can edit manually
|
56
|
-
* To generate a settings file based on the current
|
57
|
-
* To check the current configuration against a file of settings.
|
56
|
+
* To generate a settings file based on the current system configuration
|
57
|
+
* To check the current system configuration against a file of settings.
|
58
58
|
|
59
59
|
In the first case Tweek uses a built-in set of defaults. To check using these simply run:
|
60
60
|
|
@@ -62,25 +62,25 @@ In the first case Tweek uses a built-in set of defaults. To check using these si
|
|
62
62
|
tweek
|
63
63
|
```
|
64
64
|
|
65
|
-
Tweek will read the sample settings from the default file `settings/sample.set`
|
66
|
-
|
65
|
+
Tweek will read the sample settings from the default file `settings/sample.set` (which is
|
66
|
+
installed as part of the Gem) and check them. The output is self-explanatory.
|
67
67
|
|
68
68
|
All the other uses involve the settings file. Documentation is contained within the
|
69
69
|
sample settings and you should read that for a full understanding of what is possible.
|
70
70
|
|
71
71
|
## Settings File Format
|
72
72
|
|
73
|
-
The file is a
|
74
|
-
above
|
73
|
+
The settings file is a plaintext file encoded in UTF-8 (if you are running Ruby 2.0 or
|
74
|
+
above) or US-ASCII otherwise.
|
75
75
|
|
76
|
-
The overall syntax of the file was designed to be Ruby-like so enabling syntax
|
77
|
-
highlighting using Ruby as the language makes it very readable.
|
76
|
+
The overall syntax of the file was designed to be Ruby-like so that enabling syntax
|
77
|
+
highlighting (using Ruby as the language) makes it very readable.
|
78
78
|
|
79
79
|
### Comments
|
80
80
|
|
81
81
|
Comments are of two sorts:
|
82
82
|
* Inline: after the first # on any line
|
83
|
-
* Block: Following the Ruby convention these
|
83
|
+
* Block: Following the Ruby convention these begin with `=begin` and end with `=end`
|
84
84
|
|
85
85
|
### Sections
|
86
86
|
|
@@ -99,7 +99,7 @@ keywords are:
|
|
99
99
|
either a block device or filesystem path corresponding to a mounted `ext4` filesystem.
|
100
100
|
Wildcards are allowed.
|
101
101
|
* XFS - Settings for XFS filesystems. This must be followed by a parameter containing
|
102
|
-
either a block device or filesystem path corresponding to a mounted `
|
102
|
+
either a block device or filesystem path corresponding to a mounted `xfs` filesystem.
|
103
103
|
Wildcards are allowed.
|
104
104
|
|
105
105
|
### Parameters
|
@@ -116,8 +116,8 @@ For a discussion of which parameters are supported please see the sample setting
|
|
116
116
|
### Conditionals
|
117
117
|
|
118
118
|
Parameter lines can be suffixed by the word `if` and one or more conditions. These are
|
119
|
-
used to limit the scope of the parameter check to those systems where the
|
120
|
-
true. The list of conditions is
|
119
|
+
used to limit the scope of the parameter check to those systems where the condition(s) hold
|
120
|
+
true. The list of conditions is logicall AND'ed together. A condition takes the form:
|
121
121
|
|
122
122
|
```
|
123
123
|
[k|d|v] op value
|
@@ -125,11 +125,15 @@ true. The list of conditions is and'ed together. A condition takes the form:
|
|
125
125
|
|
126
126
|
Where:
|
127
127
|
* `k` is the Kernel Version, `d` is the Distro name, and `v` is the Distro version.
|
128
|
-
* The operator `op` can be equality '==', regex equality '=~'or a version comparator as
|
128
|
+
* The operator `op` can be: equality '==', regex equality '=~'or a version comparator as
|
129
129
|
per the [Rubygems](http://ruby-doc.org/stdlib-2.0.0/libdoc/rubygems/rdoc/Gem/Version.html) specification.
|
130
|
-
* The value is one of a plain string in quotes (for equality), a regex between /
|
130
|
+
* The value is one of: a plain string in quotes (for equality), a regex between /
|
131
131
|
delimiters, or a plain version string.
|
132
132
|
|
133
|
+
NOTE: The determination of the current Distro, Distro Version and Kernel Version is done
|
134
|
+
using the `lsb_release` and `uname` commands. Since these may not be installed on all
|
135
|
+
systems, you can specify these as command line options. This is also useful in testing.
|
136
|
+
|
133
137
|
## Development
|
134
138
|
|
135
139
|
Tweek was developed using the gem `bundler`. Ensure you have both this and `rake` installed using:
|
@@ -144,11 +148,7 @@ built-in Rake tasks. For a list of these type `rake -T`.
|
|
144
148
|
|
145
149
|
To install this gem onto your local machine, run `bundle exec rake install`.
|
146
150
|
|
147
|
-
To release a new version to
|
148
|
-
|
149
|
-
The author will update the version number in `version.rb`, and then run `bundle exec rake
|
150
|
-
release`, which will create a git tag for the version, push git commits and tags, and push
|
151
|
-
the `.gem` file to [rubygems.org](https://rubygems.org).
|
151
|
+
To release a new version to [rubygems.org](https://rubygems.org) please contact the author.
|
152
152
|
|
153
153
|
## Contributing
|
154
154
|
|
data/bin/tweek
CHANGED
data/lib/tweek/version.rb
CHANGED