1 files changed, 152 insertions, 0 deletions
diff --git a/docs/RelNotes/3.3.0.org b/docs/RelNotes/3.3.0.org
new file mode 100644
index 0000000..be74f19
--- /dev/null
+++ b/docs/RelNotes/3.3.0.org
@@ -0,0 +1,152 @@
+* It's Magit!  A Git Porcelain inside Emacs
+
+Magit is a text-based Git user interface that puts an unmatched focus
+on streamlining workflows.  Commands are invoked using short mnemonic
+key sequences that take the cursor’s position in the highly actionable
+interface into account to provide context-sensitive behavior.
+
+With Magit you can do nearly everything that you can do when using Git
+on the command-line, but at greater speed and while taking advantage
+of advanced features that previously seemed too daunting to use on a
+daily basis.  Many users will find that by using Magit they can become
+more effective Git user.
+
+For more information about Magit, see https://magit.vc.
+
+* Magit v3.3.0 Release Notes
+
+Released 4th October 2021 by Jonas Bernoulli.
+
+I am pleased to announce the release of Magit version 3.3.0,
+representing 88 commits by 6 contributors over two month.
+
+Also see https://emacsair.me/2021/10/04/magit-3.3.
+
+** Breaking changes
+
+- The last remaining alphabetic keys (both lower- and uppercase) are
+  now bound in ~magit-mode-map~.  ~H~ to ~magit-describe-section~, ~j~ to the
+  new ~magit-status-quick~ (or ~magit-status-jump~ in status buffers), ~J~
+  to the new ~magit-display-repository-buffer~, ~Q~ to ~magit-git-command~
+  and ~Z~ to ~magit-worktree~, and once Forge is loaded, then ~N~ to
+  ~forge-dispatch~.  (~Z~ used to be bound to ~magit-stash~, which now is
+  only available on ~z~.)  #4259, 9bec1c54a, e401bd4d3
+
+- ~I~ is now bound to ~magit-init~ instead of ~magit-gitignore~, which
+  continues to be available on ~i~.  Users of the ~magit-imerge~ package
+  (which previously bound ~i~) should consult its library header for a
+  suggestion on how to resolve the resulting conflict.  b54b537db
+
+** Changes since v3.2.0
+
+- No longer automatically add ~--full-history~ when showing a log for a
+  single file that isn't being tracked anymore.  #4381
+
+- ~magit-stash-both~ now asks before discarding merge state.  #4345
+
+- Several infix arguments, which previously could only be disabled
+  or have a numeric value, can now also be enabled without having
+  an explicit numeric value.  #4379
+
+- Added ~-Xignore-space-change~ and ~-Xignore-all-space~ to ~magit-merge~.
+  Like most newly added expert arguments they have to be explicitly
+  [[https://magit.vc/manual/transient/Enabling-and-Disabling-Suffixes.html][revealed]].  #4387
+
+- Added new command ~magit-status-quick~, which shows the status buffer
+  but avoids refreshing it for performance reasons.  #4259
+
+- Added new commands ~magit-display-repository-buffer~ (bound to ~j~ in
+  Magit buffers) and ~magit-switch-to-repository-buffer~ (bound to ~J~)
+  and variants for switching to any existing Magit buffer belonging
+  to the current repository.  #4259
+
+- Added new command ~magit-dired-am-apply-patches~ for use in Dired.
+  #4094.
+
+- Rearranged ~magit-patch~ and added a binding for ~magit-am~.  8ec3a1a21,
+  8cadf302b
+
+- Added new command ~magit-help~ (bound to ~h~ in ~magit-dispatch~), which
+  simply shows Magit's Info manual.  5bba62629
+
+- When listing entries for Imenu, then remove entry counts from group
+  titles for the benefit of third-party packages that need stable
+  titles.  #4477
+
+- Include Forge's ~pullreq~ and ~issue~ sections when listing entries for
+  Imenu.  f4016f734
+
+- Bound ~imenu~ in the ~magit-status-jump~ prefix.  678df30c3
+
+- Added new transient prefix command ~magit-bundle~, which provides
+  support for ~git bundle~.  #4392
+
+- When minibuffer completion allows for a branch or a commit to be
+  selected and the former is preferred and thus offered as default
+  then, if possible, offer the commit at point as the first choice
+  initially accessible with ~next-history-element~.  #4291
+
+- Bound ~magit-refs-set-show-commit-count~ in the ~magit-show-refs~
+  prefix.  2fe42f63d
+
+- Added new option ~magit-commit-diff-inhibit-same-window~.  #4132
+
+- Added support for invoking Smerge's "keep" commands when point is on
+  a hunk in a Magit buffer.  They can be invoked using the same key
+  bindings as in file-visiting buffers or ~RET~, ~u~, ~b~ and ~l~.  #4458
+
+- Added new command ~magit-remote-unshallow~.  #4480
+
+- Added new option ~git-commit-use-local-message-ring~.  #4503
+
+** Fixes since v3.2.0
+
+- Make ~magit-branch-remote-head~ and ~magit-branch-current~ fall back
+  to ~:inverse-video~ when the ~:box~ attribute isn't support, i.e. in
+  a terminal.  If this change does not have any effect for you then
+  your theme probably changes these faces and should stop doing so.
+  #4206
+
+- In some cases refreshing a buffer caused the cursor to jump to a
+  different position.  #4148
+
+- ~magit-convert-filename-for-git~ did not expand absolute filenames,
+  which is necessary because Git does not understand ~~/~.  de1dc8e74
+
+- ~magit-rebase~ did not enable ~--autostash~ by default but the
+  documentation says it does.  421be65a3
+
+- ~magit-clone-read-repository~ did not convert filenames before passing
+  them to Git.  4aa7d2928
+
+- Due to a regression in v2.90.0, ~magit-wip-log~ and
+  ~magit-wip-log-current~ failed to extract the previous tips of the
+  wip refs from the reflog (which is relevant when
+  ~~magit-wip-merge-branch~ is nil).  c327824b0
+
+- An old attempt to avoid needlessly updating section highlighting
+  did not actually succeed.  #3976
+
+- An error occurred when first showing a status buffer and
+  ~which-function-mode~ is enabled because that caused Imenu to collect
+  items at a time when that is not possible yet.  #4481
+
+- A change in Git v2.32.0 made it necessary to explicitly filter out
+  directories when committing to wip worktree refs.  #4499
+
+- Fixed appearance of Gravatar images by forcing their size instead
+  relying the service to return the promised size as advertised.
+  8771401d4
+
+- ~git-commit-setup~ enabled the major-mode after setting local
+  variables, which caused non-permanent variables to be reset.
+  ece2cb84d
+
+* Authors
+
+    76  Jonas Bernoulli
+     8  Kyle Meyer
+     1  Daniel Nagy
+     1  Franklin Delehelle
+     1  Jonathon McKitrick
+     1  Lin Sun