commands/cat/cat.cif
author Tom Sutcliffe <thomas.sutcliffe@accenture.com>
Sun, 18 Jul 2010 18:57:41 +0100
changeset 36 99de8c43cede
parent 0 7f656887cf89
child 83 2a78c4ff2eab
permissions -rw-r--r--
First cut of thread pools in fshell. Not fully working yet. Removed 4 overloads of CCommandBase::RunCommand[L] that are no longer used at all, and changed one more to not be exported as it's only used internally to iocli.dll. Added a thread pool (CThreadPool) to fshell so that thread commands no longer have to spawn a new thread every time they run. As part of this, CCommandWrapperBase now derives from CActive so that CThreadCommand can use its CActive-ness. CThreadCommand rejigged quite a bit to use CThreadPool (via MTaskRunner interface).

# cat.cif
# 
# Copyright (c) 2010 Accenture. All rights reserved.
# This component and the accompanying materials are made available
# under the terms of the "Eclipse Public License v1.0"
# which accompanies this distribution, and is available
# at the URL "http://www.eclipse.org/legal/epl-v10.html".
# 
# Initial Contributors:
# Accenture - Initial contribution
#

==name cat

==short-description

Concatenate the specified files and write their contents to C<stdout>.

==see-also

L<match|match>, L<tail|tail>

==argument filename file_name optional multiple

The names of the files to be concatenated. May contain wild characters C<*> and C<?>. If none specified, reads from C<stdin>.

==option bool f force

Read the files even if they are open exclusively by another process. Runs a small risk of the data read being corrupt.

==option bool b binary

Legacy option, kept for compatability. Equivalent to C<--encoding binary>.

==option enum e encoding

Encoding to use. If not specified, defaults to 'auto'.

==enum-value auto

Use charconv to try and figure out the encoding (slow and error-prone for anything other than UTF-16 with BOM).

==enum-value binary

Read the files in binary mode and do not perform any character conversion.

==enum-value utf-8

Assume the file is UTF-8 (with or without BOM).

==enum-value latin1

Assume the file is encoded using ISO-8859-1.

==enum-value ltk-utf-8

Assume the file is UTF-8, but use the RLtkBuf16 UTF-8 parser rather than the charconv one (useful for testing).

==option int s block-size

Specify the block size to use for reading the file(s), in bytes. If not specified, defaults to 512 bytes.

==copyright

Copyright (c) 2005-2010 Accenture. All rights reserved.