[elpa] externals/org-remark 9fd5ef5b74 105/173: doc: NOTICE on name change proposal

[ELPA Syncer]

branch: externals/org-remark
commit 9fd5ef5b7454ec2dfc9bee71644585724054fb6f
Author: Noboru Ota <me@nobiot.com>
Commit: Noboru Ota <me@nobiot.com>

    doc: NOTICE on name change proposal
---
 README.org | 123 ++++++++-----------------------------------------------------
 1 file changed, 16 insertions(+), 107 deletions(-)

diff --git a/README.org b/README.org
index 7085b0d09c..b7679c83f6 100644
--- a/README.org
+++ b/README.org
@@ -6,6 +6,22 @@
 
 # Note: I use the readme template that alphapapa shares on his GitHub repo 
<https://github.com/alphapapa/emacs-package-dev-handbook#template>. It works 
with the org-make-toc <https://github.com/alphapapa/org-make-toc> package, 
which automatically updates the table of contents.
 
+* ❦❦❦ IMPORTANT NOTICE ❦❦❦
+
+[This notice written on 3 January 2022]
+
+Happy 2022!
+
+I am finalizing the the name of the package and GitHub repo. See 
[[https://github.com/nobiot/org-marginalia/pull/10][PR #10]]. It's probably 
going to be "*Org-remark*". The =dev/name-change= branch contains all the 
changes pertaining to the name change along some additional features -- most 
notably, different highlighter pen colors and capability for you to create 
different pens (an idea borrowed from John Kitchin's 
[[https://github.com/jkitchin/ov-highlight][Ov-highlight]]).
+
+There will be some minor breaking changes, which I am going through right now 
in my own usage. I will document the ways to bridge the breakages; nothing 
really major and I'm also trying to make the new version as backward compatible 
as possible from my lessons learnt.
+
+After the change, I will propose the package to be added to ELPA.
+
+I would appreciate any feedback or comment via 
[[https://github.com/nobiot/org-marginalia/pull/10][PR #10]], Org-roam 
discourse, or direct email (probably not Slack or Reddit as I'm really not 
present on these media).
+
+* Intorduction
+
 Org-marginalia lets you highlight text, and write margin notes (marginalia) 
for any text file in a separate Org file. 
 
 [[./resources/images/2020-12-24T101116_Title.png]]
@@ -61,7 +77,6 @@ non-nil, Org-marginalia will add an ID property to the file 
level. This is mainl
 - [[#credits][Credits]]
 - [[#feedback][Feedback]]
 - [[#license][License]]
-- [[#marginalia-for-org-marginaliael][Marginalia for org-marginalia.el]]
 - [[#local-variables][Local Variables]]
 :END:
 
@@ -308,112 +323,6 @@ I am aiming to keep this package to be small and focused. 
I plan to add the foll
 
 This work is licensed under a GPLv3 license. For a full copy of the licese, 
refer to [[./LICENSE][LICENSE]].
 
-* Marginalia for ~org-marginalia.el~
-:PROPERTIES:
-:marginalia-source-file: ~/local-repos/org-marginalia/org-marginalia.el
-:marginalia-source-file: ~/src/org-marginalia/org-marginalia.el
-:TOC:      :depth 0
-:END:
-This section is used as a demonstration and a collection of my ideas for this 
package.
-
-** Deleted Notes
-
-I need to think it through.
-Do I want to reveal invisible elments to move, or keep it hidden.
-At the moment, ~om/list-highlights-positions~ has been changed to return 
beginning points of visible ones only -- this can be changed to make it 
opsitonal arg. For example, if I want to list *all*, including the hidden ones, 
do I want to just visible ones?
-
-** Deleted Notes on jit-lock-register
-:END:
-[[file:~/local-repos/org-marginalia/org-marginalia.el][org-marginalia]]
-
-Some syntactic elements keep their faces descpite being marked.
-It appears to be the way font-lock-mode works. Experimenting.
-This might also lead to a way for copy and paste (need to deal with duplicate 
IDs)
-#+begin_src 
-;; Comment dddd
-;; This is considered
-;; Comment
-
-;;Comment  dd
-jit-lock-register
-
-(defun)
-
-(jit-lock-register #'my/font-lock-fn)
-(font-lock-unfontify-buffer)
-(jit-lock-refontify)
-(font-lock-fontify-buffer)
-
-(point);; comment
-;; Comment 
-(my/font-lock-fn 155 160)
-
-(let ((beg 1)
-      (end 10))
-  (list beg end))
-
-(defun my/font-lock-fn (beg end &optional context)
-  (unless context
-    (list beg)
-    (if (get-char-property beg 'om/id)
-        (font-lock-unfontify-region beg end))))
-#+end_src
-
-** org-marginalia-load
-:PROPERTIES:
-:marginalia-id: 3ed4316a
-:marginalia-source-beg: 7324
-:marginalia-source-end: 7343
-:END:
-[[file:~/local-repos/org-marginalia/org-marginalia.el][org-marginalia]]
-
-
-** set-buffer-modified-p
-:PROPERTIES:
-:marginalia-id: 275b8a06
-:marginalia-source-beg: 7203
-:marginalia-source-end: 7224
-:END:
-[[file:~/local-repos/org-marginalia/org-marginalia.el][org-marginalia]]
-
-Adding overlay does not set the buffer modified.
-It's more fluid with save operation.
-You cannot use `undo' to undo highlighter.
-
-** overlay-put
-:PROPERTIES:
-:marginalia-id: 44c310d9
-:marginalia-source-beg: 6461
-:marginalia-source-end: 6472
-:END:
-[[file:~/local-repos/org-marginalia/org-marginalia.el][org-marginalia]]
-
-Do not add the =evaporate t= property for the highlight's overlay. By 
remaining in the buffer, =undo= puts overlays in their original location when 
text regions get killed and subsequently the kill gets undone.
-
-Using overlays instead of text-properties has an advantage of easy composition 
of faces; e.g. when marking on a comment line in =emacs-lisp-mode=, the 
highlighters face won't be composed onto the underlying syntax face for 
comments. Overlay can make it easy to add an additional face to comments and 
other syntactically font-locked regions.
-** (make-overlay beg end nil 'FRONT-ADVANCE)
-:PROPERTIES:
-:marginalia-id: 3ec6b5e6
-:marginalia-source-beg: 6411
-:marginalia-source-end: 6452
-:END:
-[[file:~/local-repos/org-marginalia/org-marginalia.el][org-marginalia]]
-
-It's more intuitive if editing the text both on the beg and end points of the 
highlight overlay does not extend it. Pass FRONT-ADVANCE; keep REAR-ADVANCE as 
default.
-
-#+ref: Manual (elisp)Manging Overlays
-#+begin_quote
-     The arguments FRONT-ADVANCE and REAR-ADVANCE specify the marker
-     insertion type for the start of the overlay and for the end of the
-     overlay, respectively.  *Note Marker Insertion Types::.  If they
-     are both ‘nil’, the default, then the overlay extends to include
-     any text inserted at the beginning, but not text inserted at the
-     end.  If FRONT-ADVANCE is non-‘nil’, text inserted at the beginning
-     of the overlay is excluded from the overlay.  If REAR-ADVANCE is
-     non-‘nil’, text inserted at the end of the overlay is included in
-     the overlay.
-#+end_quote
-
 * Local Variables
 
 # Local Variables: