From 6e89ce8852a5625214c4339dac991fd781083b9d Mon Sep 17 00:00:00 2001 From: Thanos Apollo Date: Sun, 18 Feb 2024 18:28:42 +0200 Subject: doc: Add sync devices & fix typos --- doc/gnosis.info | 75 +++++++++++++++++++++++++++++++++------------------------ doc/gnosis.org | 29 +++++++++++++++++----- doc/gnosis.texi | 34 +++++++++++++++++++------- 3 files changed, 92 insertions(+), 46 deletions(-) diff --git a/doc/gnosis.info b/doc/gnosis.info index 348e70a..c654fcb 100644 --- a/doc/gnosis.info +++ b/doc/gnosis.info @@ -29,6 +29,7 @@ This manual is written for Gnosis version 0.1.7, released on 2023-02-18. * Note Types:: * Customization & Extension:: * Gnosis Algorithm:: +* Sync between devices:: -- The Detailed Node Listing -- @@ -55,7 +56,6 @@ Gnosis Algorithm * Initial Interval:: * Easiness Factor:: * Forgetting Factor:: -* Auto push changes::  @@ -328,7 +328,7 @@ should be done. ‘gnosis-display’ functions  -File: gnosis.info, Node: Gnosis Algorithm, Prev: Customization & Extension, Up: Top +File: gnosis.info, Node: Gnosis Algorithm, Next: Sync between devices, Prev: Customization & Extension, Up: Top 6 Gnosis Algorithm ****************** @@ -338,7 +338,6 @@ File: gnosis.info, Node: Gnosis Algorithm, Prev: Customization & Extension, U * Initial Interval:: * Easiness Factor:: * Forgetting Factor:: -* Auto push changes::  File: gnosis.info, Node: Initial Interval, Next: Easiness Factor, Up: Gnosis Algorithm @@ -387,7 +386,7 @@ total easiness factor would be updated by adding the increase factor. (setq gnosis-algorithm-ef '(0.30 0.25 1.3))  -File: gnosis.info, Node: Forgetting Factor, Next: Auto push changes, Prev: Easiness Factor, Up: Gnosis Algorithm +File: gnosis.info, Node: Forgetting Factor, Prev: Easiness Factor, Up: Gnosis Algorithm 6.3 Forgetting Factor ===================== @@ -405,45 +404,59 @@ interval was 6 days, the next interval will be 6 * 0.5 = 3 days. (setq gnosis-algorithm-ff 0.5)  -File: gnosis.info, Node: Auto push changes, Prev: Forgetting Factor, Up: Gnosis Algorithm +File: gnosis.info, Node: Sync between devices, Prev: Gnosis Algorithm, Up: Top -6.4 Auto push changes -===================== +7 Sync between devices +********************** + +Gnosis uses git to maintain data integrity and facilitate +synchronization across devices. + + You will need to configure your remote manually. -You can interactively use ‘gnosis-vc-push’ & ‘gnosis-vc-pull’. + Example: - As the name suggests, they rely on ‘vc’ to work properly. + cd ~/.emacs.d/gnosis # default location for gnosis + git init # After completing your first review session, a git repo should have been initialized automatically. + git remote add + git push --set-upstream origin master - Make sure you have setup a git remote for gnosis. - cd ~//gnosis # default location for gnosis - git remote add # + You can interactively use ‘gnosis-vc-push’ & ‘gnosis-vc-pull’. As +the name suggests, they rely on ‘vc’ to work properly. Depending on your setup, ‘vc’ might require an external package for the ssh passphrase dialog, such as ‘x11-ssh-askpass’. + To automatically push changes after a review session, add this to +your configuration: + (setf gnosis-vc-auto-push t) + (gnosis-vc-pull) ;; Run vc-pull for gnosis on startup + + You might as well add +  Tag Table: Node: Top246 -Node: Introduction1277 -Node: Installation1757 -Node: Using straightel2034 -Node: Installing manually from source2546 -Node: Adding notes3235 -Node: Note Types4651 -Node: Cloze4875 -Node: Basic Type5848 -Node: Double6126 -Node: MCQ (Multiple Choice Question)6472 -Node: y-or-n6881 -Node: Customization & Extension7307 -Node: Adjust for typos | String Comparison8020 -Node: Creating Custom Note Types8856 -Node: Gnosis Algorithm9966 -Node: Initial Interval10190 -Node: Easiness Factor10697 -Node: Forgetting Factor11602 -Node: Auto push changes12162 +Node: Introduction1280 +Node: Installation1760 +Node: Using straightel2037 +Node: Installing manually from source2549 +Node: Adding notes3238 +Node: Note Types4654 +Node: Cloze4878 +Node: Basic Type5851 +Node: Double6129 +Node: MCQ (Multiple Choice Question)6475 +Node: y-or-n6884 +Node: Customization & Extension7310 +Node: Adjust for typos | String Comparison8023 +Node: Creating Custom Note Types8859 +Node: Gnosis Algorithm9969 +Node: Initial Interval10200 +Node: Easiness Factor10707 +Node: Forgetting Factor11612 +Node: Sync between devices12146  End Tag Table diff --git a/doc/gnosis.org b/doc/gnosis.org index b10af7a..fe5293c 100644 --- a/doc/gnosis.org +++ b/doc/gnosis.org @@ -292,17 +292,34 @@ Example configuration: (setq gnosis-algorithm-ff 0.5) #+end_src -** Auto push changes +* Sync between devices -You can interactively use =gnosis-vc-push= & =gnosis-vc-pull=. +Gnosis uses git to maintain data integrity and facilitate +synchronization across devices. -As the name suggests, they rely on =vc= to work properly. +You will need to configure your remote manually. + +Example: -Make sure you have setup a git remote for gnosis. #+begin_src bash - cd ~//gnosis # default location for gnosis - git remote add # + cd ~/.emacs.d/gnosis # default location for gnosis + git init # After completing your first review session, a git repo should have been initialized automatically. + git remote add + git push --set-upstream origin master #+end_src + +You can interactively use =gnosis-vc-push= & =gnosis-vc-pull=. As the +name suggests, they rely on =vc= to work properly. + Depending on your setup, =vc= might require an external package for the ssh passphrase dialog, such as ~x11-ssh-askpass~. + + +To automatically push changes after a review session, add this to your configuration: +#+begin_src emacs-lisp +(setf gnosis-vc-auto-push t) +(gnosis-vc-pull) ;; Run vc-pull for gnosis on startup +#+end_src + +You might as well add diff --git a/doc/gnosis.texi b/doc/gnosis.texi index 487a4c1..379dc18 100644 --- a/doc/gnosis.texi +++ b/doc/gnosis.texi @@ -53,6 +53,7 @@ Git repositories: * Note Types:: * Customization & Extension:: * Gnosis Algorithm:: +* Sync between devices:: @detailmenu --- The Detailed Node Listing --- @@ -80,7 +81,6 @@ Gnosis Algorithm * Initial Interval:: * Easiness Factor:: * Forgetting Factor:: -* Auto push changes:: @end detailmenu @end menu @@ -356,7 +356,6 @@ Optionally, you might want to create your own custom @samp{gnosis-display} funct * Initial Interval:: * Easiness Factor:: * Forgetting Factor:: -* Auto push changes:: @end menu @node Initial Interval @@ -427,20 +426,37 @@ Example configuration: (setq gnosis-algorithm-ff 0.5) @end lisp -@node Auto push changes -@section Auto push changes +@node Sync between devices +@chapter Sync between devices -You can interactively use @samp{gnosis-vc-push} & @samp{gnosis-vc-pull}. +Gnosis uses git to maintain data integrity and facilitate +synchronization across devices. -As the name suggests, they rely on @samp{vc} to work properly. +You will need to configure your remote manually. + +Example: -Make sure you have setup a git remote for gnosis. @example -cd ~//gnosis # default location for gnosis -git remote add # +cd ~/.emacs.d/gnosis # default location for gnosis +git init # After completing your first review session, a git repo should have been initialized automatically. +git remote add +git push --set-upstream origin master @end example + +You can interactively use @samp{gnosis-vc-push} & @samp{gnosis-vc-pull}. As the +name suggests, they rely on @samp{vc} to work properly. + Depending on your setup, @samp{vc} might require an external package for the ssh passphrase dialog, such as @code{x11-ssh-askpass}. + +To automatically push changes after a review session, add this to your configuration: +@lisp +(setf gnosis-vc-auto-push t) +(gnosis-vc-pull) ;; Run vc-pull for gnosis on startup +@end lisp + +You might as well add + @bye -- cgit v1.2.3