pescetti(1) [debian man page]

PESCETTI(1)						      General Commands Manual						       PESCETTI(1)

NAME

       pescetti -- Pseudo-Duplimate Generator

SYNOPSIS

       pescetti

DESCRIPTION

       This manual page documents briefly the pescetti command.

OPTIONS

       Here are a list of the available options and what they do. You must specify exactly one from --demo, --generate or --load.

       --help	 Prints the help text

       --demo	 Demonstration mode. Generates one hand with permutations and the tutorial for how to use them.

       --generate=N
		 Generate N random boards

       --load=boards.txt
		 Load boards+analysis from boards.txt

       --load-dds=boards.dds
		 Load boards from boards.dds in dds format

       --load-analysis=tricks.txt
		 Load analysis from tricks.txt

       --permutations=permutations.txt
		 Generate the permutations and save them to the given file

       --curtains=curtains.txt
		 Save curtain cards to file curtains.txt

       --save=boards.txt
		 Save the boards+analysis to boards.txt

       --save-dds=boards.dds
		 Save the boards to boards.dds in dds format

       --save-analysis=tricks.txt
		 Save the analysis to tricks.txt

       --format=html|txt|pdf
		 Set the output mode to the given format

       --title=title
		 Set the title for the output

       --output=hands.txt
		 Print the hands to hands.txt, rather than to standard output

       --stats	 Generate statistics about the set of boards; included in the hands output

       --analyze Run the dds analyzer on the boards and print the resulting numberof tricks (warning SLOW)

       --criteria=
		 A  list of criteria to apply to each generated hand to generate specific hand types.  The list should be space separated and each
		 item may be suffixed with a colon and a (fractional) probability value which can be used to weight the criteria.

		 E.g. --criteria="weaknt:0.8 strongnt:0.5"

		 Valid criteria are: unbalanced weaknt strongnt twont strongtwo weaktwo three twoclubs 4441  singlesuit  twosuits  partscore  game
		 slam game-invite slam-invite jumpshift jumpfit splinter bacon weird

       --probability=factor
		 Generate  hands matching the criteria with only the given probability. Factor is in the range 0 to 1. On each attempt to generate
		 a board it is rejected if it doesn't match the criteria with the given probability.  A factor of about  0.8  gives  roughly  half
		 matching boards

AUTHOR

       This manual page was written by Matthew Johnson <debian@matthew.ath.cx>. Permission is granted to copy, distribute and/or modify this docu-
       ment under the terms of the GNU General Public License, Version 2 as published by the Free Software Foundation.

       On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.

																       PESCETTI(1)

ARD-PARSE-BOARDS(1)					      General Commands Manual					       ARD-PARSE-BOARDS(1)

NAME

       ard-parse-boards - Read data from the Arduino boards.txt file

USAGE

       Dump all the data in the file:
	$ ard-parse-boards --dump

       See which boards we know about:
	$ ard-parse-boards --boards

       Look for a particular board...
	$ ard-parse-boards --find uno

       multiple terms are implicitly ANDed:
	$ ard-parse-boards --find duemil 328

       Dump all the data for a particular board:
	$ ard-parse-boards atmega328

       Extract a particular field:
	$ ard-parse-boards atmega328 build.f_cpu

DESCRIPTION

       The  Arduino  software package ships with a boards.txt file which tells the Arduino IDE details about particular hardware. So when the user
       says he's got a shiny new Arduino Uno, boards.txt knows that it has a 16MHz ATmega328 on it. It would be nice to access these data from the
       command line too.

       In  normal  operation  you simply specify the tag given to the board in the boards.txt file, and optionally a field name. This program then
       extracts the data to STDOUT.

       Most boards have names which are quite unwieldy, so we always refer to a board by a tag, not its name. Strictly the tag is the  bit  before
       the first dot in the boards.txt key. You can see a list of board tags and names with the "--boards" option.

OPTIONS

       --boards_txt=[file]
	      Specify the full path to the boards.txt file.

       The following options all disable the normal 'lookup' operation.

       --dump Dump the complete database in YAML format.

       --boards
	      Print a list of the tag and name of every board in the file.

       --find [query] <query> ...
	      Find  matching  data. Strictly, return a list of values which match all of the query terms, treating each term as a case-insensitive
	      regexp.

	      For example:
	       --find 328
	       List data containing 328 (anywhere in the value).

	       --find due
	       List data containing 'due' (e.g. duemilanove).

	       --find 328 due
	       List data containing both 328 and due.

BUGS AND LIMITATIONS

       There are no known bugs in this application.

       Please report problems to the author.

       Patches are welcome.

AUTHOR

       Martin Oldfield, ex-atelier@mjo.tc

       Thanks to Mark Sproul who suggested doing something like this to me ages ago.

LICENSE AND COPYRIGHT

       Copyright (c) 2011, Martin Oldfield. All rights reserved.

       This file is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as  published
       by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

       This  program  is  distributed  in  the	hope  that  it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MER-
       CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

								     MAY 2012						       ARD-PARSE-BOARDS(1)