This file is indexed.

/usr/lib/R/site-library/permute/ChangeLog is in r-cran-permute 0.8-3-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
 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
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
$Date: 2014-01-26 20:21:11 +0100 (Sun, 26 Jan 2014) $

permute ChangeLog

Version 0.8-3

	* allPerms: with free permutations *within* plots, `allPerms()`
	was not returning the indices in the original data but in the
	permutation indices within plots.

	Reported by: Joris Meys

Version 0.8-2

	* allPerms: with free permutations *within* blocks, `allPerms()`
	was not returning the indices in the original data but in the
	permutation indices within block.

	In addition, `allPerms()` was not replicating each row in a
	within-block permutation matrix for all the rows in the other
	block within-block permutation matrices. This is now achieved via
	a new, non-exported utility function `cbindAllPerms()`.

	Reported by: Joris Meys

Version 0.8-1

	* setBlocks: get block name before doing anything so that you
	really get only name instead of its evaluated value.

Version 0.8-0

	* Released to CRAN

	* DESCRIPTION: now uses `Authors@R` to populate `Author` and
	`Maintainer` fields. Finer grained recognition of contributors and
	R Core Team's copyright.

	* NEWS: added a `NEWS.Rd` file to document high-level changes to
	permute. Detailed changes remain in `ChangeLog`, whilst `NEWS.Rd`
	will summarise the main user-level changes to the package.

	* allPerms: fix a bug where the blocks of permutations were being
	recombined in the wrong way, by rows instead of by columns.

	* numPerms: was ignoring the `constant` setting if free permutations
	within level of plots.

Version 0.7-8

	* how, Plots: enforces that `blocks` and `strata` are factors, or
	can be coerced to a factor via `as.factor()`, if specified.

	* check: gains a new argument `quietly = FALSE` to suppress messages
	about updates to the permutation design when they are not needed.

	* allPerms: no longer allows  messages about generating set of
	permutations to be generated by `check()`. It calls `check()` now
	with `quietly = TRUE` to achieve this.

	* shuffleSet: played about a bit with the way the design is printed
	if you show the matrix of permutations.

Version 0.7-7

	* shuffleSet: Implemented an idea of Jari's to allow `check()` and
	`allPerms()` to do their thing and possibly generate the set of all
	permutations, rather than turn off checking. If that now results in
	more than `nset` permutations, `shuffleSet` randomly takes `nset` of
	these. This is a nice suggestion as it avoids the problem that with
	small numbers of possible permutations, you can randomly draw the
	same permutation more than once.

	As I have added this feature, I reverted some earlier changes to the
	documentation that used the `check = FALSE` in their call to
	`shuffleSet()`. The `check` argument is retained though, as a way for
	function writers to skip that part of the permute workflow if desired.

	The permutation matrix returned is now of class `"permutationMatrix"`.
	This class has `as.matrix()` and `print()` S3 methods.

	* allPerms: gains an argument `check`, which defaults to `TRUE`. This
	is used to turn off checking within `allPerms` if desired. A use-case
	for this is in `check()`, which might end up caling `allPerms()` to
	generate the set of all permutations. In that case `allPerms()` used
	to recheck the design. Now this doesn't happen.

	`allPerms` also uses the new `set<-` replacement functions rather than
	`update()` as the latter causes problems when used within functions as
	it often evaluates the stored call in the wrong environment.

	* check: following the change to `allPerms` (see above), `check()` no
	longer results in it calling itself, via `allPerms()`, when generating
	the set of possible permutations if the check heuristics indicate it
	should be.

	Turned on some `message()`s when the user asks for too many permutations
	(more than the set of possible permutations) and when the set of
	possible permutations is smaller than the `minperm` value stored in the
	`"how"` object. The latter notifies the user that the entire set of
	permutations is being generated. These messages were updated to reduce
	their length.

	`check` also uses the new `set<-` replacement functions rather than
	`update()` as the latter causes problems when used within functions as
	it often evaluates the stored call in the wrong environment.

	* Plots, Within: now return a object of class `"Plots"` or `"Within"`,
	respectively.

	* get-methods: added a number of a new methods for existing functions
	to work with `"Within"` and `"Plots"` classes.

	* set-methods: added a number of a new functions and methods with the
	common name `setFoo<-.Bar` where `Foo` is the component to be updated,
	and `Bar` is the class. These are replacement functions only. They are
	intended to be used within functions, where the user-friendly `update()`
	will have problems getting the call updated correctly ot evaluating it.

	* how, Plots, Within: Now work much harder to preserve details of the
	design (i.e. the names of objects passed for the blocks or plot strata),
	and also process the matched call so that the user can `update()` it.

	* fixupCall: a new, unexported function that allows the call objects
	stored in a `"how"` object to be updated. This is not exported as it is
	intended only for internal use. Function writers should use the
	`setFoo<-` functions instead. Ordinary users should use `update()` as
	long as it is not in a function.

	* update: new methods for objects of classes `"how"` and `"Plots".
	Thes are copies of the standard R function `update.default` with some
	changes. The source files for these two functions preserver the R
	copyright statement and document modifications made by Gavin L.
	Simpson.

	* Depends: permute requires a version of R no earlier than version
	2.14.0.

Version 0.7-6

	* summary.allPerms: Was printing two slightly different subtitles.

	* More unit tests...

Version 0.7-5

	* how: the matched call is now returned permitting the use of
	`update()` to update elements of a stored permutation design object.
	Suggested by Jari Oksanen.

	`how` also gains an argument `make` which is the user-level way
	to control whether all possible permutations are actually
	created should the heuristics in `check()` decide they should be.

	The `print` method for class "how" wasn't printing details of
	mirroring or constant settings for within-plot components.

	* shuffleSet: was incorrectly recombining individual block-level
	permutations.
	Reported by Jari Oksanen.

	Gains an argument, `check`, which allows the user to control whether
	the permutation design should be checked. In small data sets or where
	there are very few permutations, `shuffleSet` could generate more
	permutations (i.e. all possible ones) than requested. Turning off this
	checking with `check = FALSE` will result in exactly `nset`
	permutations being returned, but without a gaurantee that they will
	be unique.

	* numPerms: fixed a bug where `numPerms()` was ignoring Blocks when
	computing the number of possible permutations.

	* Within, Plots: as with `how()`, the matched call is now returned
	as part of the list object, allowing desirable `update()` behaviour.

	* allPerms, doAllPerms: now correctly work in presence of blocks,
	and where there are no plots.

	  `allPerms` now includes the permutation design (its `control`
	  argument) as an attribute, `"control"`, on the returned matrix of
	  permutations.

	  `allPerms` loses arguments `max` and `observed` as these are
	  supposed to be in the control object created by `how()`.

	  `summary.allPerms` (its `print` method, more correctly) now prints
	  the permutation design alongside the set of permutations.

	* get-methods: new extractor functions `getObserved()` and
	`getMake()` return the `observed` and `make` components of object
	created by `how()`.

	* getComplete: This now only returns the `complete` component of
	the `"how"` object. Use `getMinperm()` to extract the component
	no-longer returned by `getComplete()`.

	* check: function loses arguments `make.all` and `observed` as
	these are in the control object returned by `how()`.

	The logic of some of the checks has been tweaked slightly.

	* Documentation fixes in examples of `allPerms` and `check`.

	* permuplot: This is horribly broken and I'm not sure if it will
	ever return. In the meantime, this function now prints a warning
	message if used and returns nothing, invisibly.

	The function is no longer exported from the package namespace, and
	not documented.

	I'm not convinced that the plot can adequately convery the breadth of
	designs now possible. Hence I am minded to deprecate this in 0.8-0
	when released to CRAN and to make it defunct some thereafter.

Version 0.7-4

	* Deprecated functions: Completed the deprecation of `permCheck()`
	and `permControl()`. These functions will be made defunct following
	the release of version 0.8-0, with a view to complete removal from
	version 0.9-0 onwards.

Version 0.7-3

	* Tweak to 0.7-2 API changes: argument `blocks` no longer takes
	a list from helper function `Blocks()`. It is easier and simpler
	if this just takes a factor. In essence, `blocks` in synonymous
	with `strata` from `vegan::permuted.index` and the new change will
	allow for an easier transition.

	* get-methods: New extractor functions `getMirror()`, and
	`getConstant()` which retrieve the mirroring and constant elements
	of a permutation design.

	Also added `getRow()`, `getCol()` and `getDim()`, which extract
	the row and column dimensions of a grid permutation design, or
	both.

	In addition, new methods `getNperm()` and `getMaxperm()` return
	the number of permutations requested and the maximum nuber that
	should be allowed, respectively. New method `getComplete` extracts
	details of the complete enumeration features of permute.

	* numPerms: updated to work with the new API and now handles
	blocking. Exmaples now pass checks again.

	* allPerms: updated to the new API.

	* check: updated to the new API.

	* how: new function, a copy of `permControl()` and will eventually
	replace that function. Has a new `print` method.

	Begun process of *deprecating* `permControl()` and its `print`
	method.

	* permControl, how: the `strata.name` component of the returned
	object is no called `blocks.name`.

	* Plots: now returns the object name supplied as argument `strata`
	as component `plots.name`.

	* TODO: started a TODO list of things I know are broken or needed.

Version 0.7-2

	* Major API change: Added capability to handle true blocking
	constraints.
	Suggested by Cajo ter Braak.

	We now have:

	  o Blocks: samples are *never* permuted between blocks. Blocks
	    can't be permuted either.
	  o Plots: these define groups of samples, for example the
	    whole plots in a split-plot design, or repeated measures
	    on a set of sites. The sites are the "plots". Plots can
	    be permuted using any of the restricted schemes offered
	    in permute.
	  o Within: these are the samples, the rows in the data set.
	    They can be nested in Plots and/or in Blocks.

	This capability has made it into permControl(), shuffle() and
	shuffleSet(), though the latter certainly has one major bug
	in the case where there is more than one Block.

	Most other functionality is broken as the above change has
	altered the permControl object in a way that is not backwards
	compatible.

	Note that the 0.7.x branch is a development branch and should
	not be used in ernest until I work through all the implications
	of this change. Rest assured, I won't be doing this again!

Version 0.7-1

	* allPerms: implement Doug Bates version which simplifies and
	speeds up the code. A fast RcppEigen-based version also exists
	but will need larger changes to the package to implement.

Version 0.7-0

	* Vignette: silly typo is example code illustrating shuffle().
	New section on `shuffleSet()`.

	The Vignette is now in `vignettes` not `inst/doc`.

	* check.Rd: undo the hack needed to pass checks prior to
	vegan 2.0 being on CRAN.

	* Suggests: now needs vegan >= 2.0-0

	* shuffleGrid: was doing random flipping of permutations even
	if `mirror = FALSE` for the `constant = TRUE` case.

	* shuffleStrata: assumed that the samples were in contiguous
	blocks.
	Reported by Cajo ter Braak.

	* .Internal: removed all instances of .Internal calls in the
	code.

	* Package is now byte-compiled.

Version 0.6-1 (released to CRAN on September 7, 2011)

	* NAMESPACE: export(permuplot)

	* check.Rd: temporarily supress some of the examples to run
	only on vegan >= 2.0-0. Needed during transition to pass
	checks on CRAN until version 2.0-0 is released.

Version 0.6-0 (closed September 7, 2011)

	* allPerms: added warning regarding current need for samples
	to be arranged in order of any strata.

	* Release: Pushed to CRAN. First beta release.

Version 0.5-4 (opened August 31, 2011)

	* permCheck: deprecate `permCheck()` in favour of `check()`.

	* allPerms: code clean-up

	* preparing for first release to CRAN.

Version 0.5-3 (closed August 31, 2011)

	* shuffleSet: now handles all permutation types that are
	available in shuffle().

	* nobs.Rd: fixed an example which created a numeric vector of
	zeros instead of changing sampled vector to numeric. The example
	yielded an error in R 2.14.0 (under development) where only one
	argument was accepted for numeric() and two or more args cause an
	error. The two isTRUE() cases should be true only exceptionally,
	and may call for a fix.

	* NAMESPACE, nobs-methods.R: The package relied on import(stats,
	nobs), but that works only in R 2.13 and failed in R 2.12.2. Now
	we define and export nobs() generic in permute package for older
	R. The help file still gives a warning for missing documentation
	of nobs in R 2.12.2 and prior, but there is no obvious fix to
	this.

Version 0.5-2 (closed August 23, 2011)

	* shuffelSet: new function to generate a set of `n`
	permutations without the overhead of `n` repeated calls to
	`shuffle()`. Currently only for designs without
	strata/blocks.

Version 0.5-1 (closed July 5, 2011)

	* shuffle: now returns seq_len(n) for no permutation within
	blocks or of blocks.

	* tests: testing using the `testthat` package. Initial
	infrasctructure.

Version 0.5-0 (closed June 28, 2011)

	* shuffle: renamed permuted.index() to shuffle()
	* Vignette: the package has a vignette, which is very much
	a work-in-progress.

Version 0.0-3 (closed June 17, 2011)

	* NAMESPACE: permute gets a NAMESPACE. Needed to shield
	functions form ones of similar name in vegan.

Version 0.0-2 (closed December 09, 2010)

	* allPerms: Large update. allPerms now works for all
	permutation designs *except* when permuting both blocks
	and within blocks. This exception is handled with
	.NotYetImplemented().

	* numPerms: Wasn't returning the correct number of
	permutations when WITHIN == "none" and BLOCK != "none",
	i.e. permuting strata.

	* Utils: Utility functions defined inline within allPerms
	moved to new proper functions and renamed; allFree, allSeries
	allGrid, allStrata.

Version 0.0-1 (closed February 28, 2010)

	* SVN: Uploaded code to r-forge within vegan source tree.
	This code base represents my working version as of today,
	*not* the version in vegan at that time.