From 1148aec146e14f4e490beca612d6cb98ef847659 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 28 Apr 2024 15:20:27 +0200 Subject: Adding upstream version 2:1.19~1. Signed-off-by: Daniel Baumann --- man/go-run.1 | 66 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 66 insertions(+) create mode 100644 man/go-run.1 (limited to 'man/go-run.1') diff --git a/man/go-run.1 b/man/go-run.1 new file mode 100644 index 0000000..baf1c20 --- /dev/null +++ b/man/go-run.1 @@ -0,0 +1,66 @@ +.\" Hey, EMACS: -*- nroff -*- +.de Vb \" Begin verbatim text +.ft CW +.nf +.ne \\$1 +.. +.de Ve \" End verbatim text +.ft R +.fi +.. +.TH GO-RUN 1 "2022-08-02" +.\" Please adjust this date whenever revising the manpage. +.SH NAME +go-run \- compile and run Go program +.SH SYNOPSIS +.B go run +.RI [ "build flags" ] +.RB [ \-exec +.IR xprog ] +.I package +.RI [ arguments... ] +.SH DESCRIPTION +Run compiles and runs the named main Go package. +.br +Typically the package is specified as a list of .go source files from a single +directory, but it may also be an import path, file system path, or pattern +matching a single known package, as in 'go run .' or 'go run my/cmd'. +.P +If the package argument has a version suffix (like @latest or @v1.0.0), +"go run" builds the program in module-aware mode, ignoring the go.mod file in +the current directory or any parent directory, if there is one. This is useful +for running programs without affecting the dependencies of the main module. +.P +By default, 'go run' runs the compiled binary directly: 'a.out arguments...'. +.br +If the \-exec flag is given, 'go run' invokes the binary using xprog: + +.Vb 1 +\& 'xprog a.out arguments...'. +.Ve +.P +If the \-exec flag is not given, GOOS or GOARCH is different from the system +default, and a program named go_$GOOS_$GOARCH_exec can be found +on the current search path, 'go run' invokes the binary using that program, +for example 'go_js_wasm_exec a.out arguments...'. This allows execution of +cross-compiled programs when a simulator or other execution method is +available. +.P +By default, \(oqgo run\(cq compiles the binary without generating the information +used by debuggers, to reduce build time. To include debugger information in +the binary, use \(oqgo build\(cq. +.P +The exit status of Run is not the exit status of the compiled binary. +.P +For more about build flags, see 'go help build'. +.br +For more about specifying packages, see 'go help packages'. +.SH SEE ALSO +.BR go-build (1). +.SH AUTHOR +.PP +This manual page was written by Michael Stapelberg +and is maintained by the +Debian Go Compiler Team +based on the output of 'go help run' +for the Debian project (and may be used by others). -- cgit v1.2.3