diff --git a/README.md b/README.md index 36fb96a5..aa01be19 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,7 @@ Miniflux 2 ========== [![Build Status](https://travis-ci.org/miniflux/miniflux.svg?branch=master)](https://travis-ci.org/miniflux/miniflux) +[![GoDoc](https://godoc.org/github.com/miniflux/miniflux?status.svg)](https://godoc.org/github.com/miniflux/miniflux) [![Documentation Status](https://readthedocs.org/projects/miniflux/badge/?version=latest)](https://docs.miniflux.net/) Miniflux is a minimalist and opinionated feed reader: @@ -16,11 +17,6 @@ It's simple, fast, lightweight and super easy to install. Miniflux 2 is a rewrite of [Miniflux 1.x](https://github.com/miniflux/miniflux-legacy) in Golang. -Notes ------ - -Miniflux 2 still in development and **it's not ready to use**. - Documentation ------------- diff --git a/api/doc.go b/api/doc.go new file mode 100644 index 00000000..a43e4630 --- /dev/null +++ b/api/doc.go @@ -0,0 +1,10 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the MIT license +// that can be found in the LICENSE file. + +/* + +Package api implements API endpoints for Miniflux application. + +*/ +package api diff --git a/cli/doc.go b/cli/doc.go new file mode 100644 index 00000000..9d4954f1 --- /dev/null +++ b/cli/doc.go @@ -0,0 +1,10 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the MIT license +// that can be found in the LICENSE file. + +/* + +Package cli implements command line arguments for Miniflux application. + +*/ +package cli diff --git a/config/doc.go b/config/doc.go new file mode 100644 index 00000000..f2e9211e --- /dev/null +++ b/config/doc.go @@ -0,0 +1,10 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the MIT license +// that can be found in the LICENSE file. + +/* + +Package config handles configuration values for Miniflux application. + +*/ +package config diff --git a/crypto/doc.go b/crypto/doc.go new file mode 100644 index 00000000..2bca85af --- /dev/null +++ b/crypto/doc.go @@ -0,0 +1,10 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the MIT license +// that can be found in the LICENSE file. + +/* + +Package crypto implements helpers related to cryptography. + +*/ +package crypto diff --git a/daemon/doc.go b/daemon/doc.go new file mode 100644 index 00000000..e2469496 --- /dev/null +++ b/daemon/doc.go @@ -0,0 +1,10 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the MIT license +// that can be found in the LICENSE file. + +/* + +Package daemon handles the main application process. + +*/ +package daemon diff --git a/doc.go b/doc.go new file mode 100644 index 00000000..0d021914 --- /dev/null +++ b/doc.go @@ -0,0 +1,10 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the MIT license +// that can be found in the LICENSE file. + +/* + +Package main implements a feed reader application. + +*/ +package main diff --git a/duration/doc.go b/duration/doc.go new file mode 100644 index 00000000..8fc52969 --- /dev/null +++ b/duration/doc.go @@ -0,0 +1,10 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the MIT license +// that can be found in the LICENSE file. + +/* + +Package duration implements helpers to calculate time duration. + +*/ +package duration diff --git a/errors/doc.go b/errors/doc.go new file mode 100644 index 00000000..4c3114d9 --- /dev/null +++ b/errors/doc.go @@ -0,0 +1,10 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the MIT license +// that can be found in the LICENSE file. + +/* + +Package errors handles localized errors. + +*/ +package errors diff --git a/fever/doc.go b/fever/doc.go new file mode 100644 index 00000000..f01f098d --- /dev/null +++ b/fever/doc.go @@ -0,0 +1,10 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the MIT license +// that can be found in the LICENSE file. + +/* + +Package fever implements Fever API endpoints. + +*/ +package fever diff --git a/filter/doc.go b/filter/doc.go new file mode 100644 index 00000000..5fd9fef1 --- /dev/null +++ b/filter/doc.go @@ -0,0 +1,10 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the MIT license +// that can be found in the LICENSE file. + +/* + +Package filter implements a content filter to rewrite image links. + +*/ +package filter diff --git a/http/doc.go b/http/doc.go new file mode 100644 index 00000000..f0eb1fa6 --- /dev/null +++ b/http/doc.go @@ -0,0 +1,10 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the MIT license +// that can be found in the LICENSE file. + +/* + +Package http implements a set of utilities related to the HTTP protocol. + +*/ +package http diff --git a/integration/doc.go b/integration/doc.go new file mode 100644 index 00000000..fb1fc086 --- /dev/null +++ b/integration/doc.go @@ -0,0 +1,10 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the MIT license +// that can be found in the LICENSE file. + +/* + +Package integration implements API clients for third-party services. + +*/ +package integration diff --git a/locale/doc.go b/locale/doc.go new file mode 100644 index 00000000..5e92c6fc --- /dev/null +++ b/locale/doc.go @@ -0,0 +1,10 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the MIT license +// that can be found in the LICENSE file. + +/* + +Package locale handles the internationalization of the application. + +*/ +package locale diff --git a/logger/doc.go b/logger/doc.go new file mode 100644 index 00000000..4d63bcd6 --- /dev/null +++ b/logger/doc.go @@ -0,0 +1,10 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the MIT license +// that can be found in the LICENSE file. + +/* + +Package logger handles application log messages with different levels. + +*/ +package logger diff --git a/model/doc.go b/model/doc.go new file mode 100644 index 00000000..4718d8ae --- /dev/null +++ b/model/doc.go @@ -0,0 +1,10 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the MIT license +// that can be found in the LICENSE file. + +/* + +Package model contains all data structures used by the application. + +*/ +package model diff --git a/oauth2/doc.go b/oauth2/doc.go new file mode 100644 index 00000000..2254a3fe --- /dev/null +++ b/oauth2/doc.go @@ -0,0 +1,10 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the MIT license +// that can be found in the LICENSE file. + +/* + +Package oauth2 abstracts different OAuth2 providers. + +*/ +package oauth2 diff --git a/reader/doc.go b/reader/doc.go new file mode 100644 index 00000000..1698644a --- /dev/null +++ b/reader/doc.go @@ -0,0 +1,10 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the MIT license +// that can be found in the LICENSE file. + +/* + +Package reader implements everything related to feed parsing. + +*/ +package reader diff --git a/scheduler/doc.go b/scheduler/doc.go new file mode 100644 index 00000000..ea5becc5 --- /dev/null +++ b/scheduler/doc.go @@ -0,0 +1,10 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the MIT license +// that can be found in the LICENSE file. + +/* + +Package scheduler implements the application internal scheduler. + +*/ +package scheduler diff --git a/sql/doc.go b/sql/doc.go new file mode 100644 index 00000000..2096efc6 --- /dev/null +++ b/sql/doc.go @@ -0,0 +1,10 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the MIT license +// that can be found in the LICENSE file. + +/* + +Package sql contains all SQL queries or database schema instructions. + +*/ +package sql diff --git a/storage/doc.go b/storage/doc.go new file mode 100644 index 00000000..aede4e86 --- /dev/null +++ b/storage/doc.go @@ -0,0 +1,10 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the MIT license +// that can be found in the LICENSE file. + +/* + +Package storage implements a set of functions to interact with the database. + +*/ +package storage diff --git a/template/doc.go b/template/doc.go new file mode 100644 index 00000000..5bdae47a --- /dev/null +++ b/template/doc.go @@ -0,0 +1,10 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the MIT license +// that can be found in the LICENSE file. + +/* + +Package template handles template parsing and execution. + +*/ +package template diff --git a/timer/doc.go b/timer/doc.go new file mode 100644 index 00000000..8d330aec --- /dev/null +++ b/timer/doc.go @@ -0,0 +1,10 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the MIT license +// that can be found in the LICENSE file. + +/* + +Package timer implements utility functions to measure the execution time of a block of code. + +*/ +package timer diff --git a/ui/doc.go b/ui/doc.go new file mode 100644 index 00000000..30154e97 --- /dev/null +++ b/ui/doc.go @@ -0,0 +1,10 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the MIT license +// that can be found in the LICENSE file. + +/* + +Package ui implements handlers to render to user interface. + +*/ +package ui diff --git a/url/doc.go b/url/doc.go new file mode 100644 index 00000000..e7ddf890 --- /dev/null +++ b/url/doc.go @@ -0,0 +1,10 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the MIT license +// that can be found in the LICENSE file. + +/* + +Package url implements a set of utility functions to parse URL. + +*/ +package url diff --git a/url/url_test.go b/url/url_test.go index 13c723ae..12e131f3 100644 --- a/url/url_test.go +++ b/url/url_test.go @@ -1,3 +1,7 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the Apache 2.0 +// license that can be found in the LICENSE file. + package url import "testing" diff --git a/version/doc.go b/version/doc.go new file mode 100644 index 00000000..fd58a6d9 --- /dev/null +++ b/version/doc.go @@ -0,0 +1,10 @@ +// Copyright 2018 Frédéric Guillot. All rights reserved. +// Use of this source code is governed by the MIT license +// that can be found in the LICENSE file. + +/* + +Package version contains application and build information. + +*/ +package version diff --git a/version/version.go b/version/version.go index 0724730d..4f76433a 100644 --- a/version/version.go +++ b/version/version.go @@ -4,7 +4,7 @@ package version -// Version of the application (generate with "make build") +// Version of the application (generated with "make build") var Version = "undefined" // BuildDate is generated with "make build"