Skip to content

Commit

Permalink
Merge pull request #50 from joaoofreitas/master
Browse files Browse the repository at this point in the history
Update README file to Markdown 📃
  • Loading branch information
robpike committed Apr 29, 2021
2 parents 23def4e + 1c82741 commit 424d233
Show file tree
Hide file tree
Showing 2 changed files with 36 additions and 44 deletions.
44 changes: 0 additions & 44 deletions README

This file was deleted.

36 changes: 36 additions & 0 deletions README.md
@@ -0,0 +1,36 @@
# glog

[![PkgGoDev](https://pkg.go.dev/badge/github.com/golang/glog)](https://pkg.go.dev/github.com/golang/glog)

Leveled execution logs for Go.

This is an efficient pure Go implementation of leveled logs in the
manner of the open source C++ package [_glog_](https://github.com/google/glog).

By binding methods to booleans it is possible to use the log package without paying the expense of evaluating the arguments to the log. Through the `-vmodule` flag, the package also provides fine-grained
control over logging at the file level.

The comment from `glog.go` introduces the ideas:

Package _glog_ implements logging analogous to the Google-internal C++ INFO/ERROR/V setup. It provides the functions Info, Warning, Error, Fatal, plus formatting variants such as Infof. It also provides V-style loggingcontrolled by the `-v` and `-vmodule=file=2` flags.

Basic examples:

```go
glog.Info("Prepare to repel boarders")

glog.Fatalf("Initialization failed: %s", err)
```

See the documentation for the V function for an explanation of these examples:

```go
if glog.V(2) {
glog.Info("Starting transaction...")
}
glog.V(2).Infoln("Processed", nItems, "elements")
```

The repository contains an open source version of the log package used inside Google. The master copy of the source lives inside Google, not here. The code in this repo is for export only and is not itself under development. Feature requests will be ignored.

Send bug reports to golang-nuts@googlegroups.com.

0 comments on commit 424d233

Please sign in to comment.