Usage instructions out-of-date

[alethiophile]

Various usage instructions and examples under using/filesystem are now apparently out of date. For instance: |merge %desk [~planet-name %desk] now gives nest-fail, and only functions with |merge %desk /~planet-name/desk=; |sync %desk ~planet-name fails, requiring instead |sync %desk ~planet-name %desk (docs state the remote desk is optional if the same as the local desk); |cp /path1 /path2 %init fails, requiring no merge strategy argument.

[galenwp]

This is a good catch. Would you be up for submitting a PR?

[ohAitch]

I don't know about "out of date", none of those sound compatible with any
version of the generators I've ever seen. Definitely broken regardless.

On Wednesday, 15 June 2016, Tom Hunt notifications@github.com wrote:

Various usage instructions and examples under using/filesystem are now
apparently out of date. For instance: |merge %desk [~planet-name %desk]
now gives nest-fail, and only functions with |merge %desk
/~planet-name/desk=; |sync %desk ~planet-name fails, requiring instead |sync
%desk ~planet-name %desk (docs state the remote desk is optional if the
same as the local desk); |cp /path1 /path2 %init fails, requiring no
merge strategy argument.

—
You are receiving this because you are subscribed to this thread.
Reply to this email directly, view it on GitHub
https://github.com/urbit/docs/issues/42, or mute the thread
https://github.com/notifications/unsubscribe/ABxXhl_ZKL7Rao986gOjHq2gEaho_eKDks5qMCoegaJpZM4I2jXo
.

[alethiophile]

I could make a PR with examples of the invocations that have worked for me. I don't know enough about the underlying concepts to really correct the descriptions. (For instance, what exactly is a 'beak'? Docs say a cell [~planet-name %desk] qualifies, but that doesn't work. I don't know what's correct.)

[galenwp]

Hm. Fair. To be clear, you're referring to: http://urbit.org/docs/using/filesystem/ ? I think @ohAitch will handle this.

[ohAitch]

On it. A beak is definitely neither a ship-desk cell nor
/~doznec/home/2/web/md(which has a subpath)

On Wednesday, 15 June 2016, Galen Wolfe-Pauly notifications@github.com
wrote:

Hm. Fair. To be clear, you're referring to:
http://urbit.org/docs/using/filesystem/ ? I think @ohAitch
https://github.com/ohAitch will handle this.

—
You are receiving this because you were mentioned.
Reply to this email directly, view it on GitHub
https://github.com/urbit/docs/issues/42#issuecomment-226260334, or mute
the thread
https://github.com/notifications/unsubscribe/ABxXhpAgdExXw6SgGZT8rLXv_4IynyaXks5qMDbSgaJpZM4I2jXo
.

[galenwp]

@ohAitch should we merge your branch?

[ohAitch]

Yup, when I made the PR I thought docs also had "master == deploy" semantics

[galenwp]

Well, it looks like the PR didn't get closed for a few minor issues. You're free to close it when it's ready, of course.

And yeah: master gets deployed periodically.

[ohAitch]

Ah right, the ship vs urbit thing. I'll put it on my list