gemstash 2.7.1 → 2.8.0

data/lib/gemstash/man/gemstash-deploy.7

@@ -1,22 +1,39 @@
-<!-- Automatically generated by Pandoc -->
-.\" Automatically generated by Pandoc 3.1.8
+.\" Automatically generated by Pandoc 3.1.3
 .\"
+.\" Define V font for inline verbatim, using C font in formats
+.\" that render this, and otherwise B font.
+.ie "\f[CB]x\f[]"x" \{\
+. ftr V B
+. ftr VI BI
+. ftr VB B
+. ftr VBI BI
+.\}
+.el \{\
+. ftr V CR
+. ftr VI CI
+. ftr VB CB
+. ftr VBI CBI
+.\}
 .TH "gemstash-deploy" "7" "October 25, 2015" "" ""
+.hy
 .SH Deploying Gemstash
+.PP
 Bundler is here for the rescue to keep Gemstash up to date!
-Create a \f[CR]Gemfile\f[R] pointing to Gemstash:
+Create a \f[V]Gemfile\f[R] pointing to Gemstash:
 .IP
-.EX
+.nf
+\f[C]
 # ./Gemfile
 source \[dq]https://rubygems.org\[dq]
 gem \[dq]gemstash\[dq]
-.EE
+\f[R]
+.fi
 .PP
-Then \f[CR]bundle\f[R] to create your \f[CR]Gemfile.lock\f[R].
-When you are ready to upgrade, simply \f[CR]bundle update\f[R].
-You may need to run \f[CR]gemstash\f[R] via \f[CR]bundle exec\f[R].
-Alternatively, you can \f[CR]gem uninstall gemstash\f[R] and
-\f[CR]gem install gemstash\f[R] when you want to upgrade.
+Then \f[V]bundle\f[R] to create your \f[V]Gemfile.lock\f[R].
+When you are ready to upgrade, simply \f[V]bundle update\f[R].
+You may need to run \f[V]gemstash\f[R] via \f[V]bundle exec\f[R].
+Alternatively, you can \f[V]gem uninstall gemstash\f[R] and
+\f[V]gem install gemstash\f[R] when you want to upgrade.
 .PP
 Gemstash will automatically run any necessary migrations, so updating
 the gem is all that needs to be done.
@@ -24,21 +41,25 @@ the gem is all that needs to be done.
 It is probably wise to stop Gemstash before upgrading, then starting
 again once you are done:
 .IP
-.EX
+.nf
+\f[C]
 $ bundle exec gemstash stop
 $ bundle update
 $ bundle exec gemstash start
-.EE
+\f[R]
+.fi
 .SS Monitoring
+.PP
 Health monitoring is built in to Gemstash using the
 server_health_check-rack (https://github.com/on-site/server_health_check-rack)
 gem.
-If you request \f[CR]/health\f[R] from your Gemstash instance, you will
+If you request \f[V]/health\f[R] from your Gemstash instance, you will
 get a JSON response along with an HTTP status code indicating success or
 failure.
 The JSON response will look something like this for a success case:
 .IP
-.EX
+.nf
+\f[C]
 {
   \[dq]status\[dq]: {
     \[dq]heartbeat\[dq]: \[dq]OK\[dq],
@@ -48,16 +69,18 @@ The JSON response will look something like this for a success case:
     \[dq]db_write\[dq]: \[dq]OK\[dq]
   }
 }
-.EE
+\f[R]
+.fi
 .PP
 This request will test storage and database access and report on the
 result.
 Each key in the status can be requested alone to just report on that
 status.
 For example, if you would like a health check that doesn\[cq]t interact
-with storage or the database, you can use \f[CR]/health/heartbeat\f[R]
+with storage or the database, you can use \f[V]/health/heartbeat\f[R]
 which will always respond with a success while your Gemstash server is
 running.
 .SS Downgrading
+.PP
 It is not recommended to go backwards in Gemstash versions.
 Migrations may have run that could leave the database in a bad state.

data/lib/gemstash/man/gemstash-deploy.7.txt

@@ -1,21 +1,19 @@
-4mgemstash-deploy24m(7) 					 4mgemstash-deploy24m(7)
-
-<!-- Automatically generated by Pandoc -->
+4mgemstash-deploy24m(7)						 4mgemstash-deploy24m(7)
 
 1mDeploying Gemstash0m
        Bundler	is  here for the rescue to keep Gemstash up to date!  Create a
-       Gemfile pointing to Gemstash:
+       1mGemfile 22mpointing to Gemstash:
 
 	      # ./Gemfile
 	      source "https://rubygems.org"
 	      gem "gemstash"
 
-       Then bundle to create your Gemfile.lock.  When you  are	ready  to  up-
-       grade,  simply  bundle update.  You may need to run gemstash via bundle
-       exec.  Alternatively, you can gem uninstall gemstash  and  gem  install
-       gemstash when you want to upgrade.
+       Then 1mbundle 22mto create your 1mGemfile.lock22m.  When you  are  ready	 to  up-
+       grade,  simply  1mbundle update22m.  You may need to run 1mgemstash 22mvia 1mbundle0m
+       1mexec22m.  Alternatively, you can 1mgem uninstall gemstash  22mand  1mgem  install0m
+       1mgemstash 22mwhen you want to upgrade.
 
-       Gemstash  will  automatically run any necessary migrations, so updating
+       Gemstash	 will  automatically run any necessary migrations, so updating
        the gem is all that needs to be done.
 
        It is probably wise to stop Gemstash before  upgrading,	then  starting
@@ -26,12 +24,12 @@
 	      $ bundle exec gemstash start
 
    1mMonitoring0m
-       Health	 monitoring    is    built    in   to	Gemstash   using   the
-       server_health_check-rack 		       (https://github.com/on-
-       site/server_health_check-rack)  gem.   If you request /health from your
-       Gemstash instance, you will get a JSON response along with an HTTP sta-
-       tus code indicating success or failure.	The JSON  response  will  look
-       something like this for a success case:
+       Health	monitoring   is	  built	  in   to  Gemstash  using  the	 serv-
+       er_health_check-rack   (https://github.com/on-site/server_health_check-
+       rack)  gem.   If	 you  request 1m/health 22mfrom your Gemstash instance, you
+       will get a JSON response along with an HTTP status code indicating suc-
+       cess or failure.	 The JSON response will look something like this for a
+       success case:
 
 	      {
 		"status": {
@@ -43,15 +41,15 @@
 		}
 	      }
 
-       This  request  will  test storage and database access and report on the
-       result.	Each key in the status can be requested alone to  just	report
-       on  that  status.   For	example, if you would like a health check that
-       doesn't	interact  with	storage  or  the   database,   you   can   use
-       /health/heartbeat  which  will always respond with a success while your
+       This request will test storage and database access and  report  on  the
+       result.	 Each  key in the status can be requested alone to just report
+       on that status.	For example, if you would like	a  health  check  that
+       doesn't	 interact   with   storage   or	 the  database,	 you  can  use
+       1m/health/heartbeat 22mwhich will always respond with a success	while  your
        Gemstash server is running.
 
    1mDowngrading0m
        It is not recommended to go backwards in Gemstash versions.  Migrations
        may have run that could leave the database in a bad state.
 
-			       October 25, 2015 	    4mgemstash-deploy24m(7)
+			       October 25, 2015		    4mgemstash-deploy24m(7)

data/lib/gemstash/man/gemstash-mirror.7

@@ -1,34 +1,54 @@
-<!-- Automatically generated by Pandoc -->
-.\" Automatically generated by Pandoc 3.1.8
+.\" Automatically generated by Pandoc 3.1.3
 .\"
+.\" Define V font for inline verbatim, using C font in formats
+.\" that render this, and otherwise B font.
+.ie "\f[CB]x\f[]"x" \{\
+. ftr V B
+. ftr VI BI
+. ftr VB B
+. ftr VBI BI
+.\}
+.el \{\
+. ftr V CR
+. ftr VI CI
+. ftr VB CB
+. ftr VBI CBI
+.\}
 .TH "gemstash-mirror" "7" "October 25, 2015" "" ""
+.hy
 .SH Using Gemstash as a Mirror
-If you don\[cq]t have control over your \f[CR]Gemfile\f[R], or you
+.PP
+If you don\[cq]t have control over your \f[V]Gemfile\f[R], or you
 don\[cq]t want to force everyone on your team to go through the Gemstash
 server, you can use Bundler mirroring to bundle against your Gemstash
 server.
 .PP
-For each source in your \f[CR]Gemfile\f[R], add a mirror pointing to
-your Gemstash server:
+For each source in your \f[V]Gemfile\f[R], add a mirror pointing to your
+Gemstash server:
 .IP
-.EX
+.nf
+\f[C]
 $ bundle config mirror.http://rubygems.org http://localhost:9292
 $ bundle config mirror.https://my.gem-source.local http://localhost:9292/upstream/$(ruby -rcgi -e \[aq]puts CGI.escape(\[dq]https://my.gem-source.local\[dq])\[aq])
-.EE
+\f[R]
+.fi
 .PP
 From now on, bundler will fetch gems from those sources via your
 Gemstash server.
 .SH Simpler Gemstash Mirrors
+.PP
 \f[B]This feature requires Bundler to be at least version
-\f[CB]1.11.0\f[B].\f[R]
+\f[VB]1.11.0\f[B].\f[R]
 .PP
-If you are using Bundler version \f[CR]1.11.0\f[R] or greater, the
+If you are using Bundler version \f[V]1.11.0\f[R] or greater, the
 mirroring becomes a bit easier:
 .IP
-.EX
+.nf
+\f[C]
 $ bundle config mirror.http://rubygems.org http://localhost:9292
 $ bundle config mirror.https://my.gem-source.local http://localhost:9292
-.EE
+\f[R]
+.fi
 .PP
 Bundler will then send headers to Gemstash to indicate the correct
 upstream.

data/lib/gemstash/man/gemstash-mirror.7.txt

@@ -1,13 +1,11 @@
-4mgemstash-mirror24m(7) 					 4mgemstash-mirror24m(7)
-
-<!-- Automatically generated by Pandoc -->
+4mgemstash-mirror24m(7)						 4mgemstash-mirror24m(7)
 
 1mUsing Gemstash as a Mirror0m
-       If you don't have control over your Gemfile, or you don't want to force
-       everyone  on  your  team to go through the Gemstash server, you can use
+       If you don't have control over your 1mGemfile22m, or you don't want to force
+       everyone	 on  your  team to go through the Gemstash server, you can use
        Bundler mirroring to bundle against your Gemstash server.
 
-       For each source in your Gemfile, add a mirror pointing to your Gemstash
+       For each source in your 1mGemfile22m, add a mirror pointing to your Gemstash
        server:
 
 	      $ bundle config mirror.http://rubygems.org http://localhost:9292
@@ -19,7 +17,7 @@
 1mSimpler Gemstash Mirrors0m
        1mThis feature requires Bundler to be at least version 1.11.0.0m
 
-       If  you	are using Bundler version 1.11.0 or greater, the mirroring be-
+       If  you	are using Bundler version 1m1.11.0 22mor greater, the mirroring be-
        comes a bit easier:
 
 	      $ bundle config mirror.http://rubygems.org http://localhost:9292
@@ -28,4 +26,4 @@
        Bundler will then send headers to Gemstash to indicate the correct  up-
        stream.
 
-			       October 25, 2015 	    4mgemstash-mirror24m(7)
+			       October 25, 2015		    4mgemstash-mirror24m(7)

data/lib/gemstash/man/gemstash-multiple-sources.7

@@ -1,46 +1,68 @@
-<!-- Automatically generated by Pandoc -->
-.\" Automatically generated by Pandoc 3.1.8
+.\" Automatically generated by Pandoc 3.1.3
 .\"
+.\" Define V font for inline verbatim, using C font in formats
+.\" that render this, and otherwise B font.
+.ie "\f[CB]x\f[]"x" \{\
+. ftr V B
+. ftr VI BI
+. ftr VB B
+. ftr VBI BI
+.\}
+.el \{\
+. ftr V CR
+. ftr VI CI
+. ftr VB CB
+. ftr VBI CBI
+.\}
 .TH "gemstash-multiple-sources" "7" "October 8, 2015" "" ""
+.hy
 .SH Multiple Gem Sources
+.PP
 Gemstash will stash from any amount of gem sources.
 By the end of this guide, you will be able to bundle using multiple gem
 sources, all stashed within your Gemstash server.
 .SS Default Source
+.PP
 When you don\[cq]t provide an explicit source (as with the Quickstart
 Guide), your gems will be fetched from https://rubygems.org.
 This default source is not set in stone.
 To change it, you need only edit the Gemstash configuration found at
-\f[CR]\[ti]/.gemstash/config.yml\f[R]:
+\f[V]\[ti]/.gemstash/config.yml\f[R]:
 .IP
-.EX
+.nf
+\f[C]
 # \[ti]/.gemstash/config.yml
 ---
 :rubygems_url: https://my.gem-source.local
-.EE
+\f[R]
+.fi
 .PP
 Make sure to restart your Gemstash server after changing the config:
 .IP
-.EX
+.nf
+\f[C]
 $ gemstash stop
 $ gemstash start
-.EE
+\f[R]
+.fi
 .PP
-Once restarted, bundling against \f[CR]http://localhost:9292\f[R] will
-fetch gems from \f[CR]https://my.gem-source.local\f[R].
+Once restarted, bundling against \f[V]http://localhost:9292\f[R] will
+fetch gems from \f[V]https://my.gem-source.local\f[R].
 If you had bundled before making these changes, fear not; bundling with
 a different default gem source will store gems in a separate location,
 ensuring different sources won\[cq]t leak between each other.
 .SS Bundling with Multiple Sources
+.PP
 Changing the default source won\[cq]t help you if you need to bundle
 against https://rubygems.org along with additional sources.
 If you need to bundle with multiple gem sources, Gemstash doesn\[cq]t
 need to be specially configured.
 Your Gemstash server will honor any gem source specified via a
 specialized URL.
-Consider the following \f[CR]Gemfile\f[R]:
+Consider the following \f[V]Gemfile\f[R]:
 .IP
-.EX
+.nf
+\f[C]
 # ./Gemfile
 require \[dq]cgi\[dq]
 source \[dq]http://localhost:9292\[dq]
@@ -53,26 +75,29 @@ end
 source \[dq]http://localhost:9292/upstream/my-other.gem-source.local\[dq] do
   gem \[dq]my-other-gem\[dq]
 end
-.EE
+\f[R]
+.fi
 .PP
-Notice the \f[CR]CGI.escape\f[R] call in the second source.
+Notice the \f[V]CGI.escape\f[R] call in the second source.
 This is important, as it properly URL escapes the source URL so Gemstash
 knows what gem source you want.
-The \f[CR]/upstream\f[R] prefix tells Gemstash to use a gem source other
+The \f[V]/upstream\f[R] prefix tells Gemstash to use a gem source other
 than the default source.
 You can now bundle with the additional source.
 .PP
 Notice that the third source doesn\[cq]t need to be escaped.
-This is because the \f[CR]https://\f[R] is used by default when no
-scheme is set, and the source URL does not contain any characters that
-need to be escaped.
+This is because the \f[V]https://\f[R] is used by default when no scheme
+is set, and the source URL does not contain any characters that need to
+be escaped.
 .SS Authentication with Multiple Sources
+.PP
 You can use basic authentication or API keys on sources directly in
 Gemfile or using ENV variables on the Gemstash instance.
 .PP
-Example \f[CR]Gemfile\f[R]:
+Example \f[V]Gemfile\f[R]:
 .IP
-.EX
+.nf
+\f[C]
 # ./Gemfile
 require \[dq]cgi\[dq]
 source \[dq]http://localhost:9292\[dq]
@@ -84,47 +109,55 @@ end
 source \[dq]http://localhost:9292/upstream/#{CGI.escape(\[dq]api_key\[at]my-other.gem-source.local\[dq])}\[dq] do
   gem \[dq]my-other-gem\[dq]
 end
-.EE
+\f[R]
+.fi
 .PP
-If you set \f[CR]GEMSTASH_<HOST>\f[R] ENV variable with your
-authentication information, you can omit it from the \f[CR]Gemfile\f[R]:
+If you set \f[V]GEMSTASH_<HOST>\f[R] ENV variable with your
+authentication information, you can omit it from the \f[V]Gemfile\f[R]:
 .IP
-.EX
+.nf
+\f[C]
 # ./Gemfile
 source \[dq]http://localhost:9292\[dq]
 
 source \[dq]http://localhost:9292/upstream/my.gem-source.local\[dq] do
   gem \[dq]my-gem\[dq]
 end
-.EE
+\f[R]
+.fi
 .PP
 And run the Gemstash with the credentials set in an ENV variable:
 .IP
-.EX
+.nf
+\f[C]
 GEMSTASH_MY__GEM___SOURCE__LOCAL=user:password gemstash start --config-file config.yml.erb
-.EE
+\f[R]
+.fi
 .PP
 The name of the ENV variable is the uppercase version of the host name,
-with all \f[CR].\f[R] characters replaced with \f[CR]__\f[R], all
-\f[CR]-\f[R] with \f[CR]___\f[R] and a \f[CR]GEMSTASH_\f[R] prefix (it
-uses the same syntax as
+with all \f[V].\f[R] characters replaced with \f[V]__\f[R], all
+\f[V]-\f[R] with \f[V]___\f[R] and a \f[V]GEMSTASH_\f[R] prefix (it uses
+the same syntax as
 Bundler (https://bundler.io/v2.4/man/bundle-config.1.html#CREDENTIALS-FOR-GEM-SOURCES)).
 .PP
-Example: \f[CR]my.gem-source.local\f[R] =>
-\f[CR]GEMSTASH_MY__GEM___SOURCE__LOCAL\f[R]
+Example: \f[V]my.gem-source.local\f[R] =>
+\f[V]GEMSTASH_MY__GEM___SOURCE__LOCAL\f[R]
 .SS Redirecting
+.PP
 Gemstash supports an alternate mode of specifying your gem sources.
 If you want Gemstash to redirect Bundler to your given gem sources, then
-you can specify your \f[CR]Gemfile\f[R] like so:
+you can specify your \f[V]Gemfile\f[R] like so:
 .IP
-.EX
+.nf
+\f[C]
 # ./Gemfile
 require \[dq]cgi\[dq]
 source \[dq]http://localhost:9292/redirect/#{CGI.escape(\[dq]https://rubygems.org\[dq])}\[dq]
 gem \[dq]rubywarrior\[dq]
-.EE
+\f[R]
+.fi
 .PP
-Notice the \f[CR]/redirect\f[R] prefix.
+Notice the \f[V]/redirect\f[R] prefix.
 This prefix tells Gemstash to redirect API calls to the provided URL.
 Redirected calls like this will not be cached by Gemstash, and gem files
 will not be stashed, even if they were previously cached or stashed from

data/lib/gemstash/man/gemstash-multiple-sources.7.txt

@@ -1,17 +1,15 @@
 4mgemstash-multiple-sources24m(7)		       4mgemstash-multiple-sources24m(7)
 
-<!-- Automatically generated by Pandoc -->
-
 1mMultiple Gem Sources0m
        Gemstash will stash from any amount of gem sources.  By the end of this
        guide,  you  will  be  able  to	bundle using multiple gem sources, all
        stashed within your Gemstash server.
 
    1mDefault Source0m
-       When you don't provide an  explicit  source  (as  with  the  Quickstart
+       When you don't provide an  explicit  source  (as	 with  the  Quickstart
        Guide),	your gems will be fetched from https://rubygems.org.  This de-
        fault source is not set in stone.  To change it, you need only edit the
-       Gemstash configuration found at ~/.gemstash/config.yml:
+       Gemstash configuration found at 1m~/.gemstash/config.yml22m:
 
 	      # ~/.gemstash/config.yml
 	      ---
@@ -22,18 +20,18 @@
 	      $ gemstash stop
 	      $ gemstash start
 
-       Once restarted, bundling against http://localhost:9292 will fetch  gems
-       from  https://my.gem-source.local.   If	you  had bundled before making
+       Once restarted, bundling against 1mhttp://localhost:9292 22mwill fetch  gems
+       from  1mhttps://my.gem-source.local22m.	 If  you  had bundled before making
        these changes, fear not; bundling with a different default  gem	source
-       will  store  gems  in  a  separate location, ensuring different sources
+       will  store  gems  in  a	 separate location, ensuring different sources
        won't leak between each other.
 
    1mBundling with Multiple Sources0m
-       Changing the default source won't  help	you  if  you  need  to	bundle
+       Changing the default source won't  help	you  if	 you  need  to	bundle
        against	https://rubygems.org  along  with  additional sources.	If you
        need to bundle with multiple gem sources, Gemstash doesn't need	to  be
        specially  configured.	Your Gemstash server will honor any gem source
-       specified via a specialized URL.  Consider the following Gemfile:
+       specified via a specialized URL.	 Consider the following 1mGemfile22m:
 
 	      # ./Gemfile
 	      require "cgi"
@@ -48,21 +46,21 @@
 		gem "my-other-gem"
 	      end
 
-       Notice the CGI.escape call in the second source.  This is important, as
+       Notice the 1mCGI.escape 22mcall in the second source.  This is important, as
        it properly URL escapes the source  URL	so  Gemstash  knows  what  gem
-       source  you  want.   The  /upstream  prefix tells Gemstash to use a gem
+       source  you  want.   The	 1m/upstream  22mprefix tells Gemstash to use a gem
        source other than the default source.  You can now bundle with the  ad-
        ditional source.
 
        Notice  that  the third source doesn't need to be escaped.  This is be-
-       cause the https:// is used by default when no scheme is	set,  and  the
+       cause the 1mhttps:// 22mis used by default when no scheme is  set,  and	the
        source URL does not contain any characters that need to be escaped.
 
    1mAuthentication with Multiple Sources0m
-       You  can  use  basic  authentication or API keys on sources directly in
+       You  can	 use  basic  authentication or API keys on sources directly in
        Gemfile or using ENV variables on the Gemstash instance.
 
-       Example Gemfile:
+       Example 1mGemfile22m:
 
 	      # ./Gemfile
 	      require "cgi"
@@ -76,8 +74,8 @@
 		gem "my-other-gem"
 	      end
 
-       If you set GEMSTASH_<HOST> ENV variable with your authentication infor-
-       mation, you can omit it from the Gemfile:
+       If you set 1mGEMSTASH_<HOST> 22mENV variable with your authentication infor-
+       mation, you can omit it from the 1mGemfile22m:
 
 	      # ./Gemfile
 	      source "http://localhost:9292"
@@ -91,26 +89,26 @@
 	      GEMSTASH_MY__GEM___SOURCE__LOCAL=user:password gemstash start --config-file config.yml.erb
 
        The name of the ENV variable is the uppercase version of the host name,
-       with all . characters replaced with __, all - with ___ and a  GEMSTASH_
-       prefix	   (it	   uses     the     same     syntax	as     Bundler
+       with all 1m. 22mcharacters replaced with 1m__22m, all 1m- 22mwith 1m___ 22mand a	 1mGEMSTASH_0m
+       prefix	   (it	   uses	    the	    same     syntax	as     Bundler
        (https://bundler.io/v2.4/man/bundle-config.1.html#CREDENTIALS-FOR-GEM-
        SOURCES)).
 
-       Example: my.gem-source.local => GEMSTASH_MY__GEM___SOURCE__LOCAL
+       Example: 1mmy.gem-source.local 22m=> 1mGEMSTASH_MY__GEM___SOURCE__LOCAL0m
 
    1mRedirecting0m
        Gemstash supports an alternate mode of specifying your gem sources.  If
        you want Gemstash to redirect Bundler to your given gem	sources,  then
-       you can specify your Gemfile like so:
+       you can specify your 1mGemfile 22mlike so:
 
 	      # ./Gemfile
 	      require "cgi"
 	      source "http://localhost:9292/redirect/#{CGI.escape("https://rubygems.org")}"
 	      gem "rubywarrior"
 
-       Notice  the  /redirect  prefix.	This prefix tells Gemstash to redirect
+       Notice  the  1m/redirect	 22mprefix.  This prefix tells Gemstash to redirect
        API calls to the provided URL.  Redirected calls like this will not  be
        cached  by  Gemstash,  and  gem files will not be stashed, even if they
        were previously cached or stashed from the same gem source.
 
-				October 8, 2015   4mgemstash-multiple-sources24m(7)
+				October 8, 2015	  4mgemstash-multiple-sources24m(7)