1 .TH LPLC "1" "2017-02-09" "lplc 0.1" "User Commands" 2 .SH NAME 3 lplc \- Lichen Python-like compiler 4 .SH SYNOPSIS 5 .B lplc 6 .RI [ options ] 7 .I file 8 .br 9 .B lplc 10 .I --help 11 .br 12 .B lplc 13 .I --version 14 .SH DESCRIPTION 15 Compile the program whose principal file is given in place of 16 .IR file . 17 .SH OPTIONS 18 The following options may be specified: 19 .PP 20 .TP 21 .B \-c 22 Only partially compile the program; do not attempt to build or link it 23 .TP 24 .B \-g 25 Generate debugging information for the built executable 26 .TP 27 .B \-q 28 Silence messages produced when building an executable 29 .TP 30 .B \-r 31 Reset (discard) cached program information; inspect the whole program again 32 .TP 33 .B \-t 34 Silence timing messages 35 .TP 36 .B \-tb 37 Provide a traceback for any internal errors (development only) 38 .TP 39 .B \-v 40 Report compiler activities in a verbose fashion (development only) 41 .PP 42 Some options may be followed by values, either immediately after the option 43 (without any space between) or in the arguments that follow them: 44 .PP 45 .TP 46 .B \-o 47 Indicate the output executable name 48 .TP 49 .B \-W 50 Show warnings on the topics indicated 51 .PP 52 Currently, the following warnings are supported: 53 .TP 54 .B all 55 Show all possible warnings 56 .TP 57 .B args 58 Show invocations where a callable may be involved that cannot accept 59 the arguments provided 60 .PP 61 The following informational options can be specified to produce output instead 62 of compiling a program: 63 .PP 64 .TP 65 .B \-\-help 66 Show a summary of the command syntax and options 67 .TP 68 .B \-\-version 69 Show version information for this tool 70 .SH COPYRIGHT 71 Copyright \(co 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 72 2014, 2015, 2016, 2017 Paul Boddie <paul@boddie.org.uk> 73 .PP 74 This program is free software; you may redistribute it under the terms of 75 the GNU General Public License version 3 or (at your option) a later version. 76 This program has absolutely no warranty. 77 .SH SEE ALSO 78 .BR cc (1), 79 .BR make (1). 80 .SH RESOURCES 81 The project Web site: http://projects.boddie.org.uk/Lichen