RubyGems Documentation Server

[mindshadow]

The RubyGems Documentation Server is installed as part of ruby
1.9.2p0; but when one chooses it from the start menu, it starts up and
then appears to do nothing.

Two lines beginning with "Server started at..." appear and a blinking
cursor appears on the third line.

Input is ignored, except for ctrl-C, which produces the message
Terminate batch job (Y/N)?
Typing either Y or N terminates the batch job.

[Roy Pardee]

That's expected behavior, isn't it?  You've got to point a browser at http://localhost:8808 to request doc pages I think.

--
You received this message because you are subscribed to the Google Groups "RubyInstaller" group.
To post to this group, send email to rubyin...@googlegroups.com.
To unsubscribe from this group, send email to rubyinstalle...@googlegroups.com.
For more options, visit this group at http://groups.google.com/group/rubyinstaller?hl=en.

--
Roy Pardee
http://facebook.com/rpardee

[mindshadow]

Thanks, Roy. That helped.

Actually, as a non-initiate, I expected documentation to appear when I
clicked the link in the Start Menu, just as happens when I click on
Ruby 1.9.2-p0 API Reference or The Book of Ruby. The command that is
executed apparently fires up the server(s) but does not then open the
relevant page in the default browser.

What seems to work is to
* first select RubyGems Documentation Server (from the Start Menu);
* then point a browser at http://localhost:8808 (as you advised).

I guess this makes sense if you already know how to do it, but it's
not obvious to someone who is new to Ruby.



On Dec 3, 7:41 pm, Roy Pardee <rpar...@gmail.com> wrote:
> That's expected behavior, isn't it?  You've got to point a browser athttp://localhost:8808to request doc pages I think.

>
>
>
>
>
>
>
>
>
> On Fri, Dec 3, 2010 at 4:14 PM, mindshadow <cdwy...@gmail.com> wrote:
> > The RubyGems Documentation Server is installed as part of ruby
> > 1.9.2p0; but when one chooses it from the start menu, it starts up and
> > then appears to do nothing.
>
> > Two lines beginning with "Server started at..." appear and a blinking
> > cursor appears on the third line.
>
> > Input is ignored, except for ctrl-C, which produces the message
> >    Terminate batch job (Y/N)?
> > Typing either Y or N terminates the batch job.
>
> > --
> > You received this message because you are subscribed to the Google Groups
> > "RubyInstaller" group.
> > To post to this group, send email to rubyin...@googlegroups.com.
> > To unsubscribe from this group, send email to

> > rubyinstalle...@googlegroups.com<rubyinstaller%2Bunsu...@googlegroups.com>
> > .

[Roy Pardee]

Aye--true enough.  It'd be nice if that command also launched a browser for you, but I don't think it does.  It'd be easy to do in a batch file I think:

  start gem server
  start http://localhost:8808

Probably there's a slicker way to do it, but that seems to work...

To unsubscribe from this group, send email to rubyinstalle...@googlegroups.com.

For more options, visit this group at http://groups.google.com/group/rubyinstaller?hl=en.

[Luis Lavena]

On Sat, Dec 4, 2010 at 12:36 AM, mindshadow <cdw...@gmail.com> wrote:

Thanks, Roy.  That helped.

Actually, as a non-initiate, I expected documentation to appear when I
clicked the link in the Start Menu, just as happens when I click on
Ruby 1.9.2-p0 API Reference or The Book of Ruby.  The command that is
executed apparently fires up the server(s) but does not then open the
relevant page in the default browser.

What seems to work is to
* first select RubyGems Documentation Server (from the Start Menu);
* then point a browser at http://localhost:8808 (as you advised).

I guess this makes sense if you already know how to do it, but it's
not obvious to someone who is new to Ruby.

This is an awesome opportunity to improve the gem server behavior, as RubyGems team is wrapping things for 1.4 release.

Would you mind open an Issue for us with your feature suggestion? we can provide the patches to RubyGems in some sort of "--launch" parameter so when the server is started, it fires the browser.

Thank you for your feedback.

--
Luis Lavena
AREA 17
-
Perfection in design is achieved not when there is nothing more to add,
but rather when there is nothing more to take away.
Antoine de Saint-Exupéry

[Gordon Thiesfeld]

On Dec 4, 2010, at 9:00 AM, Luis Lavena <luisl...@gmail.com> wrote:

On Sat, Dec 4, 2010 at 12:36 AM, mindshadow <cdw...@gmail.com> wrote:

Thanks, Roy.  That helped.

Actually, as a non-initiate, I expected documentation to appear when I
clicked the link in the Start Menu, just as happens when I click on
Ruby 1.9.2-p0 API Reference or The Book of Ruby.  The command that is
executed apparently fires up the server(s) but does not then open the
relevant page in the default browser.

What seems to work is to
* first select RubyGems Documentation Server (from the Start Menu);
* then point a browser at http://localhost:8808 (as you advised).

I guess this makes sense if you already know how to do it, but it's
not obvious to someone who is new to Ruby.

This is an awesome opportunity to improve the gem server behavior, as RubyGems team is wrapping things for 1.4 release.

Would you mind open an Issue for us with your feature suggestion? we can provide the patches to RubyGems in some sort of "--launch" parameter so when the server is started, it fires the browser.

Thank you for your feedback.

--
Luis Lavena
AREA 17
-

I believe Shopify's Vision app works in a similar fashion. It might be a good place to look. 

[mindshadow]

I've written up an issue but cannot find any way to add it. The
Issues tab doesn't appear to have an Add button, and the New issue tab
says "No tracker is associated to this project. Please check the
Project settings." Any suggestions?


On Dec 4, 9:00 am, Luis Lavena <luislav...@gmail.com> wrote:

> On Sat, Dec 4, 2010 at 12:36 AM, mindshadow <cdwy...@gmail.com> wrote:
> > Thanks, Roy.  That helped.
>
> > Actually, as a non-initiate, I expected documentation to appear when I
> > clicked the link in the Start Menu, just as happens when I click on
> > Ruby 1.9.2-p0 API Reference or The Book of Ruby.  The command that is
> > executed apparently fires up the server(s) but does not then open the
> > relevant page in the default browser.
>
> > What seems to work is to
> > * first select RubyGems Documentation Server (from the Start Menu);

> > * then point a browser athttp://localhost:8808(as you advised).

[Luis Lavena]

On Sat, Dec 4, 2010 at 7:06 PM, mindshadow <cdw...@gmail.com> wrote:

I've written up an issue but cannot find any way to add it.  The
Issues tab doesn't appear to have an Add button, and the New issue tab
says "No tracker is associated to this project. Please check the
Project settings."  Any suggestions?

I don't know where are you trying to add the issue, but here is the link:

https://github.com/oneclick/rubyinstaller/issues

[mindshadow]

On the http://www.ruby-lang.org/en/libraries/ page, I found this link
Issue Tracking: Report or help solve issues in Ruby. (http://
redmine.ruby-lang.org/)

From there, I found
http://redmine.ruby-lang.org/wiki/ruby/HowtoReport
http://redmine.ruby-lang.org/projects/ruby/issues

After going to the page you supplied (https://github.com/oneclick/
rubyinstaller/issues)
and signing up, I find a Create Issue button, but when I click that, I
am sent to
https://github.com/
which has nothing to do with creating issues.


On Dec 4, 4:13 pm, Luis Lavena <luislav...@gmail.com> wrote:

[Luis Lavena]

On Sat, Dec 4, 2010 at 7:54 PM, mindshadow <cdw...@gmail.com> wrote:

On the http://www.ruby-lang.org/en/libraries/ page, I found this link
Issue Tracking: Report or help solve issues in Ruby. (http://
redmine.ruby-lang.org/)

From there, I found
http://redmine.ruby-lang.org/wiki/ruby/HowtoReport
http://redmine.ruby-lang.org/projects/ruby/issues

That is Ruby, we're talking about RubyInstaller and the shortcut.

 

After going to the page you supplied (https://github.com/oneclick/
rubyinstaller/issues)
and signing up, I find a Create Issue button, but when I click that, I
am sent to
https://github.com/
which has nothing to do with creating issues.

Dunno what browser are you using, but if you had problems with GitHub site, that is something else that I can't help you with.

[mindshadow]

Firefox. I was able to get through using IE8. I will follow up with
github.


On Dec 4, 4:58 pm, Luis Lavena <luislav...@gmail.com> wrote:
> On Sat, Dec 4, 2010 at 7:54 PM, mindshadow <cdwy...@gmail.com> wrote:
> > On thehttp://www.ruby-lang.org/en/libraries/page, I found this link

[Roy Pardee]

FWIW--I added a thread to rubygems' "suggestions" board:

http://help.rubygems.org/discussions/suggestions/24-gem-server-should-start-a-browser-pointed-at-the-newly-started-server

--
You received this message because you are subscribed to the Google Groups "RubyInstaller" group.
To post to this group, send email to rubyin...@googlegroups.com.

To unsubscribe from this group, send email to rubyinstalle...@googlegroups.com.

For more options, visit this group at http://groups.google.com/group/rubyinstaller?hl=en.

[Gordon Thiesfeld]

> --
> Roy Pardee
> http://facebook.com/rpardee
>

I've forked rubygems on github, and made a gem_server_launch branch
[1]. I have made the necessary changes[2]. I have not tested them on
any other OS than Windows yet. I'd appreciate it if Luis, or anyone
else could review it for me.

[1] https://github.com/vertiginous/rubygems/commits/gem_server_launch
[2] https://github.com/vertiginous/rubygems/commit/28822b581aa5645d7dd6247bd5e49c72c389635f

[Luis Lavena]

On Sun, Dec 5, 2010 at 12:42 PM, Gordon Thiesfeld <gthie...@gmail.com> wrote:

I've forked rubygems on github, and made a gem_server_launch branch
[1].  I have made the necessary changes[2].  I have not tested them on
any other OS than Windows yet.  I'd appreciate it if Luis, or anyone
else could review it for me.

[1] https://github.com/vertiginous/rubygems/commits/gem_server_launch
[2] https://github.com/vertiginous/rubygems/commit/28822b581aa5645d7dd6247bd5e49c72c389635f

Thank you Gordon, your modifications looks good, but I would suggest a small change.

Instead of considering launch a boolean, allow to take a value.

Saying this because 'start' works on Windows and 'open' works on Darwin and some Linux, but depending on the user system, the way to open web pages differ.

If you take a closer look at launchy, will see they cover so many cases:

https://github.com/copiousfreetime/launchy/blob/master/lib/launchy/browser.rb

I will not suggest add all that logic to RubyGems, but instead allow an easy override of launch value, defaulting to 'start' on Windows and 'open' on *nix.

Then is up to the user specify --launch=firefox if they want to open with it instead of their default chrome.

Thank you for making the fork Gordon, once you're ready send the pull request and I'll get it merged.

[Gordon Thiesfeld]

Good idea, Luis. I've updated it per your suggestion [1]. If the
user provides a command with --launch=command , the command will be
used to attempt to open the browser. If no command is given (ie.
--launch), it will default to 'start' on Windows, and 'open'
everywhere else.

This should probably be documented somewhere, but I'm not sure the
best place. Perhaps in Gem::Commands::ServerCommand#description ?

Gordon

[1] https://github.com/vertiginous/rubygems/commit/585ee90fa289baee2e58c0ff897570c4fb4a0b67

[Luis Lavena]

On Sun, Dec 5, 2010 at 3:02 PM, Gordon Thiesfeld <gthie...@gmail.com> wrote:

Good idea, Luis.  I've updated it per your suggestion [1].  If the
user provides a command with --launch=command , the command will be
used to attempt to open the browser.  If no command is given (ie.
--launch), it will default to 'start' on Windows, and 'open'
everywhere else.

This should probably be documented somewhere, but I'm not sure the
best place.  Perhaps in Gem::Commands::ServerCommand#description ?

Well, I'm not sure.

I think the modification is enough to be submitted for inclusion. If more documentation than "gem help server" is needed, then that can be added later.

Thank you Gordon for working on this.

-- 

[Gordon Thiesfeld]

On Sun, Dec 5, 2010 at 12:19 PM, Luis Lavena <luisl...@gmail.com> wrote:.

> I think the modification is enough to be submitted for inclusion. If more
> documentation than "gem help server" is needed, then that can be added
> later.
> Thank you Gordon for working on this.
> --
> Luis Lavena
> AREA 17
> -
> Perfection in design is achieved not when there is nothing more to add,
> but rather when there is nothing more to take away.
> Antoine de Saint-Exupéry
>

> --

Pull request sent. I also created a rubyinstaller branch to add the
--launch switch to the Rubygems Documentation Server icon.