bin/gemstash fails with Could not find command "readme"

[technicalpickles]

This is specifically about running gemstash in development, but I'm able to do things like bin/gemstash start, but bin/gemstash or anything that would do help usage fails like:

❯ bin/gemstash                                                                                                                                                                                                  
Could not find command "readme".

This is the only place I can find readme mentioned:

gemstash/lib/gemstash/cli.rb

Lines 40 to 49 in e0e1b4b

	command ||= "readme"
	page = manpage(command)
	if page && which("man")
	exec "man", page
	elsif page
	puts File.read("#{page}.txt")
	else
	super
	end

[olleolleolle]

Perhaps the casing changed, and we need to support the uppercase README (md) file, here?

EDIT: no, the issue is that bundle exec rake doc when run, does not create .1 files, but .1.md files, in the man/ directory.

[technicalpickles]

Forgot to post this, but I was able to confirm that running rake doc does create the files it's looking for, ie /Users/josh.nichols/workspace/gemstash/lib/gemstash/man/gemstash-readme.7

This is definitely specific to local development. I'm not sure what, if anything, should happen to read from the local files in this case 🤔

[olleolleolle]

@technicalpickles Yeah, but it is a weird location to use, isn't it? lib/gemstash/man/ rather than man/, I mean. EDIT: It's the one we use.

[olleolleolle]

@technicalpickles Thanks, coming back to this, perhaps the message could explain "if you're in local dev, please regenerate docs"?

[technicalpickles]

Yeah, that makes sense to me 👍🏻 I was trying to think how you might determine that, and I think checking $0 == "bin/gemstash" might be the easiest way?