tweek 0.9.7 → 0.9.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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