luci-go: Tools for working with BSD style ar archives.

common/archive/ar/doc.go

Index: common/archive/ar/doc.go
diff --git a/common/archive/ar/doc.go b/common/archive/ar/doc.go
new file mode 100644
index 0000000000000000000000000000000000000000..2e50c98989291a45d8146695e18cc604be1d3cd8
--- /dev/null
+++ b/common/archive/ar/doc.go
@@ -0,0 +1,17 @@
+// Copyright 2016 The LUCI Authors. All rights reserved.
+// Use of this source code is governed under the Apache License, Version 2.0
+// that can be found in the LICENSE file.
+
+// Package ar implements access to ar archives. ar is probably the simplest
+// format that standard tools under Linux support.
+//
+// The base ar format only supports files which are 16 characters long. There
+// are multiple methods for supporting longer file names.
+//
+// This package only supports the "BSD variant" as the filename is stored allow
+// "streaming" support (rather than the Sys V / GNU variant which requires
+// building a symbol table).
+//
+// References:
+// * https://en.wikipedia.org/wiki/Ar_(Unix)
+package ar