Tldr: page request: rename (macOS)

[phrohdoh]

http://plasmasturm.org/code/rename/#TUTORIAL

[sbrl]

Hey there, @Phrohdoh! Which OS and client are you using? When I do tldr rename, I see one in the linux platform.

[phrohdoh]

macOS and whichever client is installed via brew install tldr, sorry I won't be at my machine to check for quite some time.

[sbrl]

I see. No problem @Phrohdoh! I'm unsure as to whether rename on macOS work identically to that we have in the linux page. If so, we should move the linux copy into common, and then create windows-specific version of the page.

Does anyone have a mac we can use to check? I forget who does that I can @mention.

[phrohdoh]

https://github.com/Homebrew/homebrew-core/blob/5fa9dd480c91e8aa64cb546982256c9d2aba73ae/Formula/tldr.rb#L4 is tldr-c-client.

[sbrl]

Ah, I see. Could you check to see if the linux page matches the functionality you see in the macOS rename command please? This determines where we need to go next with this.

[phrohdoh]

Per that link:

NOTE: this page refers to the command from the util-linux package. For the Perl version, see file-rename or perl-rename.

http://plasmasturm.org/code/rename/rename is perl, so they are not the same.

[phrohdoh]

@zdroid for my edification, why was this given the clients label?

[zlatanvasovic]

Because I thought it's a client issue (a page in linux folder not displayed on macOS). But since it's a new page, then it definitely should have that label... :smile:

[sbrl]

Ah, I see. Thanks for the clarification @Phrohdoh. In that case, we should have a separate page for rename on macos. Strange - you don't often find a command that is present on 3 different platforms but functions in 3 different ways....! I will update the title of this issue.

Do you want to have a go yourself creating this page?

Pages are best created by people who understand the command they are about.

If you do, take a quick read of CONTRIBUTING.md, which guides you through the process of creating a new page here. Then, just simply send a pull request to this repository - and if you need any assistance, just ask :-)

[cr33dx]

There is no default rename command in mac os (Catalina) or older.
There is a man page for rename though.
It says rename is a system call

https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/rename.2.html

[sbrl]

Ah, I see @cr33dx, so this is a new feature as of Catalina? We should definitely mention that in the page then. Unfortunately, I don't have access to a mac, so I can't write the page. Do you want to have a go?

[phrohdoh]

This confusion is entirely my fault as I was not sufficiently clear, I apologize.

I am using rename which was installed via brew install rename and am requesting a tldr entry for that rename. I know nothing about the syscall.

[cr33dx]

@sbrl apologies for confusion, by older i meant earlier version too did not have rename in cli, it's a syscall.
i have macos catalina and it too does not have rename command.

I think the latest comment by @Phrohdoh clears out the confusion.

[sbrl]

I see! Thanks for clearing that up :-)

[sesam]

> brew info rename
rename: stable 1.601 (bottled), HEAD
Perl-powered file rename script with many helpful built-ins
http://plasmasturm.org/code/rename
Conflicts with: <-- it gets tricky right around here
  util-linux (because both install `rename` binaries)

Can tldr distinguish between these somehow? Something like a disambiguation flagging that Wikipedia uses.

[sbrl]

Hrm. At the moment this algorithm is used to resolve page names. We've got a name conflict with dep in #4476, but that one was easily solved because 1 command was deprecated.

[bl-ue]

Thank you @nikisix for fixing this in PR #4946! Next time, please link the issue number in the PR description so that GitHub automatically closes the issue when the PR is merged.