Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Typo at perlfaq8 #78

Closed
wants to merge 23 commits into from
Closed

Conversation

joaquinferrero
Copy link

No description provided.

@karenetheridge
Copy link
Member

Please could you rebase that to remove the merge commits, and collapse like changes together?

@joaquinferrero
Copy link
Author

Sorry, Karen, but... I don't know how I can to rebase this mess. Any tip?

@karenetheridge
Copy link
Member

Make sure you've got the updated master pulled down, then check out your branch and git rebase master. Then force-push back up to github and the pull request will automatically update. If you're not used to rebasing, I suggest checking out some tutorials - interactive rebasing in particular is really awesome, and I rely on it heavily when developing in multiple branches at once.

Copy link
Member

@karenetheridge karenetheridge left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It looks like most of the other changes in this pull request are now reversions of previous fixes, so I won't comment on each one. Could you please fix, and rebase?

Please look up how to do an interactive rebase, and squash all the similar commits together, on top of the upstream master branch. It should be a lot more clear then what changes you intend to make now, and the inadvertent reversions should disappear.

lib/perlfaq6.pod Outdated
@@ -114,7 +114,7 @@ be mangled by many mailers):
$/ = ''; # read in whole paragraph, not just one line
while ( <> ) {
while ( /^From /gm ) { # /m makes ^ match next to \n
print "leading From in paragraph $.\n";
print "leading from in paragraph $.\n";
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The text being matched is "From", so it was correct before.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok

lib/perlfaq5.pod Outdated
@@ -1539,7 +1539,7 @@ a similar interface, but does the traversal for you too:
(contributed by brian d foy)

If you have an empty directory, you can use Perl's built-in C<rmdir>.
If the directory is not empty (so, with files or subdirectories), you
If the directory is not empty (so, no files or subdirectories), you
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This was just corrected (by you) in commit 9f41196. Why is it being reverted again?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry, Karen. I mess all this pull.. Sorry. I will try to repair it.

Copy link
Author

@joaquinferrero joaquinferrero Feb 28, 2019

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Karen, Can you remove all these commits/branch? Next, I can to resend all the changes into a new pull request.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No, you can fix it all yourself in this branch. https://git-scm.com/book/en/v2/Git-Tools-Rewriting-History This is a very important skill to learn.

Copy link
Author

@joaquinferrero joaquinferrero Feb 28, 2019

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe the problem that I edited & pulled the changes with github only. I don't have a cloned git repository of perlfaq at my computer. I use the option of github of "edit this file" (in other words, fork the perlfaq repository, edit file(s), create pull request, all within github web pages).

@karenetheridge
Copy link
Member

To rebase, this is what I would do:

  • start in the master branch. git checkout master
  • you made your changes right in master (not a good idea); let's move them to their own branch. git checkout -b jf/typos
  • make sure that the latest changes from upstream are pulled down (you should have this remote already, but probably named something else.) git checkout master; git remote add upstream [email protected]:perl-doc-cats/perlfaq.git; git reset --hard upstream/master
  • go into your pull request branch and bring the commits from master into it, and clean them up. git checkout jf/typos; git rebase -i master
  • this is where the tutorial comes in. you are now in an editor and you can move around your commits, squash them together, etc. I suspect that they should all be collapsed together into one commit, but I haven't looked closely. To do that, change all lines but the first from pick to squash, and save/exit the editor. Now you're in the editor for the commit message - edit all the text down to something short and descriptive, like 'fix typos'. Save/quit.
  • use git log --oneline --graph --decorate and git log -p to confirm that you are up-to-date with master, there are no merge commits remaining, and your desired changes are still there.
  • when ready, git push -u origin jf/typos, and come to this pull request and edit the branch that the pull request comes from. Never use master for pull requests - it makes it harder to manage multiple changes at once!

@karenetheridge
Copy link
Member

Ok. I rebased it locally and then merged it. thanks!

karenetheridge added a commit that referenced this pull request Nov 2, 2019
  * fix bad pod markup in perlfaq8 (PR #78; thanks, Joaquín Ferrero!)
  * remove stale section about lib.pm (PR #82, Dan Book)
  * update perlfaq9 to reference Email::Stuffer (PR #79, Dan Book)
  * update perlfaq9 to reference URL::Search (PR #80, Dan Book)
  * update perlfaq9 to use HTTP::Tiny (PR #81, Dan Book)
  * fix some broken links (issue #71, dctabuyz)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants