summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/README.mdwn2
-rw-r--r--doc/forum/5.3.5_errors_building_with_Stack.mdwn38
-rw-r--r--doc/forum/5.3.5_errors_building_with_Stack/comment_1_bf0296c4293a52b4533a9465795366e4._comment7
-rw-r--r--doc/forum/5.3.5_errors_building_with_Stack/comment_2_be534b87de24660fb8565c2916ddefb5._comment12
-rw-r--r--doc/forum/5.3.5_import_errors.mdwn35
-rw-r--r--doc/forum/5.3.5_import_errors/comment_1_13d5f4cc224ad25ab3f1c78061ff4423._comment8
-rw-r--r--doc/forum/5.3.5_import_errors/comment_2_32d521dad51ada52e98c9540ab97add6._comment21
-rw-r--r--doc/forum/5.3.5_import_errors/comment_3_a4774959fd93039d49196e7cff232089._comment21
-rw-r--r--doc/forum/5.3.5_import_errors/comment_4_916f29264dbb8060ce4c1cd559aa028f._comment13
-rw-r--r--doc/forum/__42____42___warning:___42____42___Your___126____47__.propellor__47___is_out_of_date../comment_15_35822590f6eeab15f6d1b25ac2bcbba7._comment10
-rw-r--r--doc/news/version_5.3.5.mdwn7
-rw-r--r--doc/todo/depend_on_concurrent-output.mdwn23
-rw-r--r--doc/todo/factor_out_Grub.configured_for_any___47__etc__47__default_config.mdwn17
-rw-r--r--doc/todo/factor_out_Grub.configured_for_any___47__etc__47__default_config/comment_1_5039acea906faba7a0b33094028a475f._comment12
14 files changed, 225 insertions, 1 deletions
diff --git a/doc/README.mdwn b/doc/README.mdwn
index df1b8ada..c1550d23 100644
--- a/doc/README.mdwn
+++ b/doc/README.mdwn
@@ -56,4 +56,4 @@ see [configuration for the Haskell newbie](https://propellor.branchable.com/hask
7. Write some neat new properties and send patches!
(Want to get your feet wet with propellor before plunging in?
-[try this|http://propellor.branchable.com/forum/Simple_quickstart_without_git__44___SSH__44___GPG])
+[try this](http://propellor.branchable.com/forum/Simple_quickstart_without_git__44___SSH__44___GPG])
diff --git a/doc/forum/5.3.5_errors_building_with_Stack.mdwn b/doc/forum/5.3.5_errors_building_with_Stack.mdwn
new file mode 100644
index 00000000..bdda6bca
--- /dev/null
+++ b/doc/forum/5.3.5_errors_building_with_Stack.mdwn
@@ -0,0 +1,38 @@
+I'm able to reproduce the following with a freshly cloned Propellor:
+
+ > stack build
+ propellor-5.3.5: build (lib + exe)
+ Preprocessing library propellor-5.3.5...
+ [ 43 of 171] Compiling Propellor.Types ( src/Propellor/Types.hs, .stack-work/dist/x86_64-linux-nopie/Cabal-1.24.2.0/build/Propellor/Types.o )
+
+ /home/jayess/code/propellor/src/Propellor/Types.hs:251:37: error:
+ • Could not deduce (Monoid (Property setupmetatypes))
+ arising from a use of ‘<>’
+ from the context: (Sem.Semigroup (Property setupmetatypes),
+ Sem.Semigroup (Property undometatypes))
+ bound by the instance declaration
+ at src/Propellor/Types.hs:(245,9)-(248,74)
+ • In the first argument of ‘RevertableProperty’, namely
+ ‘(s1 <> s2)’
+ In the expression: RevertableProperty (s1 <> s2) (u2 <> u1)
+ In an equation for ‘<>’:
+ (RevertableProperty s1 u1) <> (RevertableProperty s2 u2)
+ = RevertableProperty (s1 <> s2) (u2 <> u1)
+
+ /home/jayess/code/propellor/src/Propellor/Types.hs:251:48: error:
+ • Could not deduce (Monoid (Property undometatypes))
+ arising from a use of ‘<>’
+ from the context: (Sem.Semigroup (Property setupmetatypes),
+ Sem.Semigroup (Property undometatypes))
+ bound by the instance declaration
+ at src/Propellor/Types.hs:(245,9)-(248,74)
+ • In the second argument of ‘RevertableProperty’, namely
+ ‘(u2 <> u1)’
+ In the expression: RevertableProperty (s1 <> s2) (u2 <> u1)
+ In an equation for ‘<>’:
+ (RevertableProperty s1 u1) <> (RevertableProperty s2 u2)
+ = RevertableProperty (s1 <> s2) (u2 <> u1)
+
+ -- While building package propellor-5.3.5 using:
+ /home/jayess/.stack/setup-exe-cache/x86_64-linux-nopie/Cabal-simple_mPHDZzAJ_1.24.2.0_ghc-8.0.2 --builddir=.stack-work/dist/x86_64-linux-nopie/Cabal-1.24.2.0 build lib:propellor exe:propellor exe:propellor-config --ghc-options " -ddump-hi -ddump-to-file"
+ Process exited with code: ExitFailure 1
diff --git a/doc/forum/5.3.5_errors_building_with_Stack/comment_1_bf0296c4293a52b4533a9465795366e4._comment b/doc/forum/5.3.5_errors_building_with_Stack/comment_1_bf0296c4293a52b4533a9465795366e4._comment
new file mode 100644
index 00000000..03121a74
--- /dev/null
+++ b/doc/forum/5.3.5_errors_building_with_Stack/comment_1_bf0296c4293a52b4533a9465795366e4._comment
@@ -0,0 +1,7 @@
+[[!comment format=mdwn
+ username="joey"
+ subject="""comment 1"""
+ date="2018-04-30T13:23:47Z"
+ content="""
+Think I've fixed this now.
+"""]]
diff --git a/doc/forum/5.3.5_errors_building_with_Stack/comment_2_be534b87de24660fb8565c2916ddefb5._comment b/doc/forum/5.3.5_errors_building_with_Stack/comment_2_be534b87de24660fb8565c2916ddefb5._comment
new file mode 100644
index 00000000..43e83fb7
--- /dev/null
+++ b/doc/forum/5.3.5_errors_building_with_Stack/comment_2_be534b87de24660fb8565c2916ddefb5._comment
@@ -0,0 +1,12 @@
+[[!comment format=mdwn
+ username="jsza"
+ avatar="http://cdn.libravatar.org/avatar/72c6bc8c0cdfb0fff175e90c3b036415"
+ subject="comment 2"
+ date="2018-04-30T14:27:19Z"
+ content="""
+Nice, thank you! Can confirm that it's now working for me.
+
+I'd also just like to say that using Propellor to manage our eleven or so TF2 game servers has been an absolute pleasure and a time saver.
+
+Thanks for all the work you've put into making Propellor so awesome.
+"""]]
diff --git a/doc/forum/5.3.5_import_errors.mdwn b/doc/forum/5.3.5_import_errors.mdwn
new file mode 100644
index 00000000..f69934f2
--- /dev/null
+++ b/doc/forum/5.3.5_import_errors.mdwn
@@ -0,0 +1,35 @@
+Hello, with the new 5.3.5 version,I have these errors now.
+
+At least for the two first I know that I need to add the dependencies to the executable.
+but for the last one, I do not know how to proceed properly.
+
+Cheers
+
+
+ Building executable 'propellor-config' for propellor-5.3.5..
+ [1 of 1] Compiling Main ( executables/propellor-config.hs, dist/build/propellor-config/propellor-config-tmp/Main.o )
+
+ executables/propellor-config.hs:14:1-25: error:
+ Could not find module ‘System.Posix.Files’
+ Perhaps you meant System.Posix.Types (from base-4.10.1.0)
+ Use -v to see a list of the files searched for.
+ |
+ 14 | import System.Posix.Files
+ | ^^^^^^^^^^^^^^^^^^^^^^^^^
+
+ executables/propellor-config.hs:15:1-66: error:
+ Could not find module ‘System.FilePath.Posix’
+ Use -v to see a list of the files searched for.
+ |
+ 15 | import System.FilePath.Posix ((</>), dropExtension, takeDirectory)
+ | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+ executables/propellor-config.hs:28:1-23: error:
+ Could not find module ‘Utility.FileMode’
+ it is a hidden module in the package ‘propellor-5.3.5’
+ Use -v to see a list of the files searched for.
+ |
+ 28 | import Utility.FileMode
+ | ^^^^^^^^^^^^^^^^^^^^^^^
+
+ HsCompilation exited abnormally with code 1 at Sun Apr 29 09:35:08
diff --git a/doc/forum/5.3.5_import_errors/comment_1_13d5f4cc224ad25ab3f1c78061ff4423._comment b/doc/forum/5.3.5_import_errors/comment_1_13d5f4cc224ad25ab3f1c78061ff4423._comment
new file mode 100644
index 00000000..e06e4683
--- /dev/null
+++ b/doc/forum/5.3.5_import_errors/comment_1_13d5f4cc224ad25ab3f1c78061ff4423._comment
@@ -0,0 +1,8 @@
+[[!comment format=mdwn
+ username="picca"
+ avatar="http://cdn.libravatar.org/avatar/7e61c80d28018b10d31f6db7dddb864c"
+ subject="comment 1"
+ date="2018-04-29T16:05:18Z"
+ content="""
+I solved my problem by creating a SiteSpecific module directly in the library part of Propellor
+"""]]
diff --git a/doc/forum/5.3.5_import_errors/comment_2_32d521dad51ada52e98c9540ab97add6._comment b/doc/forum/5.3.5_import_errors/comment_2_32d521dad51ada52e98c9540ab97add6._comment
new file mode 100644
index 00000000..6edd05d7
--- /dev/null
+++ b/doc/forum/5.3.5_import_errors/comment_2_32d521dad51ada52e98c9540ab97add6._comment
@@ -0,0 +1,21 @@
+[[!comment format=mdwn
+ username="joey"
+ subject="""comment 2"""
+ date="2018-04-30T13:24:30Z"
+ content="""
+Seems this must be caused by [[!commit d8d2faece72eabd18c2ff303e5fb63c3a69961f6]]
+
+And I guess you've modified the config.hs in propellor
+for your own systems?
+
+You will indeed need to add dependencies to the cabal stanza for
+propellor-config.
+
+I think that you may be able to add Other-Modules: Utility.FileMode
+to the cabal stanza for propellor-config and get access to the unexported
+module that way. Not 100% sure.
+
+I'm curious: Is there part of propellor's published modules that made you
+need something from Utility.FileMode to use it, or were you writing your
+own property and happened to use something from Utility.FileMode?
+"""]]
diff --git a/doc/forum/5.3.5_import_errors/comment_3_a4774959fd93039d49196e7cff232089._comment b/doc/forum/5.3.5_import_errors/comment_3_a4774959fd93039d49196e7cff232089._comment
new file mode 100644
index 00000000..c861f1cc
--- /dev/null
+++ b/doc/forum/5.3.5_import_errors/comment_3_a4774959fd93039d49196e7cff232089._comment
@@ -0,0 +1,21 @@
+[[!comment format=mdwn
+ username="picca"
+ avatar="http://cdn.libravatar.org/avatar/7e61c80d28018b10d31f6db7dddb864c"
+ subject="comment 3"
+ date="2018-05-01T07:07:54Z"
+ content="""
+* Do you think that I should use a dedicated config-soleil.hs file instead of the config.hs file ?
+
+* I use the combinesModes in order to set the right mode.
+
+ +rra :: Property UnixLike
+ +rra = fetch `onChange` execmode
+ + where
+ + fetch :: Property UnixLike
+ + fetch = property \"install rra scripts\"
+ + (liftIO $ toResult <$> download \"https://archives.eyrie.org/software/devel/backport\" \"/usr/local/bin/backport\")
+ +
+ + execmode :: Property UnixLike
+ + execmode = File.mode \"/usr/local/bin/backport\" (combineModes (ownerWriteMode:readModes ++ executeModes))
+
+"""]]
diff --git a/doc/forum/5.3.5_import_errors/comment_4_916f29264dbb8060ce4c1cd559aa028f._comment b/doc/forum/5.3.5_import_errors/comment_4_916f29264dbb8060ce4c1cd559aa028f._comment
new file mode 100644
index 00000000..ef3f4dad
--- /dev/null
+++ b/doc/forum/5.3.5_import_errors/comment_4_916f29264dbb8060ce4c1cd559aa028f._comment
@@ -0,0 +1,13 @@
+[[!comment format=mdwn
+ username="joey"
+ subject="""comment 4"""
+ date="2018-05-03T16:30:15Z"
+ content="""
+I don't think you need to use a different name for your config file, unless
+it somehow makes things easier for you.
+
+It's fine to use `Utility.*` like that, but do note that there's no guaranteed
+API stability for those. OTOH, if you might later contribute some
+properties built using `Utility.*` back to propellor, it certianly makes
+sense to use those.
+"""]]
diff --git a/doc/forum/__42____42___warning:___42____42___Your___126____47__.propellor__47___is_out_of_date../comment_15_35822590f6eeab15f6d1b25ac2bcbba7._comment b/doc/forum/__42____42___warning:___42____42___Your___126____47__.propellor__47___is_out_of_date../comment_15_35822590f6eeab15f6d1b25ac2bcbba7._comment
new file mode 100644
index 00000000..70e31058
--- /dev/null
+++ b/doc/forum/__42____42___warning:___42____42___Your___126____47__.propellor__47___is_out_of_date../comment_15_35822590f6eeab15f6d1b25ac2bcbba7._comment
@@ -0,0 +1,10 @@
+[[!comment format=mdwn
+ username="picca"
+ avatar="http://cdn.libravatar.org/avatar/7e61c80d28018b10d31f6db7dddb864c"
+ subject="comment 15"
+ date="2018-04-29T16:06:12Z"
+ content="""
+Hello,
+
+--allow-unrelated-history is your friend :)
+"""]]
diff --git a/doc/news/version_5.3.5.mdwn b/doc/news/version_5.3.5.mdwn
new file mode 100644
index 00000000..a7da0f0c
--- /dev/null
+++ b/doc/news/version_5.3.5.mdwn
@@ -0,0 +1,7 @@
+propellor 5.3.5 released with [[!toggle text="these changes"]]
+[[!toggleable text="""
+ * Apt.stdSourcesList now adds stable-updates suite
+ Thanks, Sean Whitton
+ * Significantly increased propellor build speed when your config.hs
+ is in a fork of the propellor repository, by avoiding redundant builds
+ of propellor library."""]] \ No newline at end of file
diff --git a/doc/todo/depend_on_concurrent-output.mdwn b/doc/todo/depend_on_concurrent-output.mdwn
index cf985166..c3641385 100644
--- a/doc/todo/depend_on_concurrent-output.mdwn
+++ b/doc/todo/depend_on_concurrent-output.mdwn
@@ -3,4 +3,27 @@ should be converted to a dependency.
Waiting on concurrent-output reaching Debian stable.
+> Well, it's in stable now. Not in oldstable yet, and propellor is still
+> supporting the current oldstable, I believe.. --[[Joey]]
+
[[!tag user/joey]]
+
+> This was attempted again in 2018 and had to be reverted
+> in [[!commit b6ac64737b59e74d4aa2d889690e8fab3772d2c6]].
+>
+> The strange output I was seeing is the first line
+> of "apt-cache policy apache2" (but not subsequent lines)
+> and the ssh-keygen command run by `genSSHFP'`
+
+> Propellor also misbehaved in some other ways likely due to not seeing
+> the command output it expected. In particular Git.cloned must have
+> failed to see an origin url in git config output, because it nuked and
+> re-cloned a git repo (losing data).
+>
+> So, it seems that readProcess was somehow leaking output to the console
+> and also likely not providing it to the caller.
+>
+> The affected system had libghc-concurrent-output-dev 1.10.5-1 installed
+> from debian. That is a somewhat old version and perhaps it was buggy?
+> However, I have not had any luck reproducing the problem there running
+> readProcess in ghci. --[[Joey]]
diff --git a/doc/todo/factor_out_Grub.configured_for_any___47__etc__47__default_config.mdwn b/doc/todo/factor_out_Grub.configured_for_any___47__etc__47__default_config.mdwn
new file mode 100644
index 00000000..16c791cd
--- /dev/null
+++ b/doc/todo/factor_out_Grub.configured_for_any___47__etc__47__default_config.mdwn
@@ -0,0 +1,17 @@
+It would be useful to have a property to set key value pairs in /etc/default configs. The code is in Grub.configured. I have not written a patch yet because I am not sure what the module should be called. Possibilities are:
+
+ & EtcDefault.set "anacron" "ANACRON_RUN_ON_BATTERY_POWER" "no"
+
+or maybe
+
+ & ConfFile.hasShellSetting "/etc/default/anacron" ("ANACRON_RUN_ON_BATTERY_POWER", "no")
+
+Or possibly both of these, with the former implemented in terms of the latter.
+
+Notes:
+
+* The use of a tuple for the last two parameters ensures that the property can be used infix.
+
+* I think this property should deduplicate the config key after setting it. I.e. after uncommenting and modifying ANACRON_RUN_ON_BATTERY_POWER it should remove any further ANACRON_RUN_ON_BATTERY_POWER settings further down the config. This allows a seamless transition from just using File.containsLine to add to the end of the file.
+
+--spwhitton
diff --git a/doc/todo/factor_out_Grub.configured_for_any___47__etc__47__default_config/comment_1_5039acea906faba7a0b33094028a475f._comment b/doc/todo/factor_out_Grub.configured_for_any___47__etc__47__default_config/comment_1_5039acea906faba7a0b33094028a475f._comment
new file mode 100644
index 00000000..b4b924ac
--- /dev/null
+++ b/doc/todo/factor_out_Grub.configured_for_any___47__etc__47__default_config/comment_1_5039acea906faba7a0b33094028a475f._comment
@@ -0,0 +1,12 @@
+[[!comment format=mdwn
+ username="joey"
+ subject="""comment 1"""
+ date="2018-05-03T16:46:45Z"
+ content="""
+Agreed on all points, also there are some
+`File.containsLine` properties for /etc/default files elsewhere that
+don't necessarily work correctly if a later line changes the value,
+that could be converted to use this new property.
+
+Your name ideas sound fine to me.
+"""]]