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..3310b9e97109d9b8a047cbcab4810d665afe3cec
--- /dev/null
+++ b/common/archive/ar/doc.go
@@ -0,0 +1,15 @@
+// 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" because it doesn't require building symbol tables
+// like the Sys V / GNU variant.
+//
+// References:
+// * https://en.wikipedia.org/wiki/Ar_(Unix)
+package ar