ISSUES

   1 = Issues
   2
   3 mailto:unicorn-public@bogomips.org is the best place to report bugs,
   4 submit patches and/or obtain support after you have searched the
   5 {email archives}[http://bogomips.org/unicorn-public/] and
   6 {documentation}[http://unicorn.bogomips.org/].
   7
   8 * No subscription will ever be required to email the public inbox.
   9 * Cc: all participants in a thread or commit, as subscription is optional
  10 * Do not {top post}[http://catb.org/jargon/html/T/top-post.html] in replies
  11 * Quote as little as possible of the message you're replying to
  12 * Do not send HTML mail, it will be flagged as spam
  13 * Anonymous and pseudonymous messages will always be welcome.
  14
  15 If your issue is of a sensitive nature or you're just shy in public,
  16 then feel free to email us privately at mailto:unicorn@bogomips.org
  17 instead and your issue will be handled discreetly.
  18
  19 If you don't get a response within a few days, we may have forgotten
  20 about it so feel free to ask again.
  21
  22 == Bugs in related projects
  23
  24 unicorn is sometimes affected by bugs in its dependencies.  Bugs
  25 triggered by unicorn in mainline Ruby, rack, GNU C library (glibc),
  26 or the Linux kernel will be reported upstream and fixed.
  27
  28 For bugs in Ruby itself, we may forward bugs to
  29 https://bugs.ruby-lang.org/ and discuss+fix them on the ruby-core
  30 list at mailto:ruby-core@ruby-lang.org
  31 Subscription to post is required to ruby-core, unfortunately:
  32 mailto:ruby-core-request@ruby-lang.org?subject=subscribe
  33
  34 For uncommon bugs in Rack, we may forward bugs to
  35 mailto:rack-devel@googlegroups.com and discuss there.
  36 Subscription (without any web UI or Google account) is possible via:
  37 mailto:rack-devel+subscribe@googlegroups.com
  38 Note: not everyone can use the proprietary bug tracker used by Rack,
  39 but their mailing list remains operational.
  40
  41 Uncommon bugs we encounter in the Linux kernel should be Cc:-ed to the
  42 Linux kernel mailing list (LKML) at mailto:linux-kernel@vger.kernel.org
  43 and subsystem maintainers such as mailto:netdev@vger.kernel.org
  44 (for networking issues).  It is expected practice to Cc: anybody
  45 involved with any problematic commits (including those in the
  46 Signed-off-by: and other trailer lines).  No subscription is necessary,
  47 and the our mailing list follows the same conventions as LKML for
  48 interopability.  There is a kernel.org Bugzilla instance, but it is
  49 ignored by most developers.
  50
  51 Likewise for any rare glibc bugs we might encounter, we should Cc:
  52 mailto:libc-alpha@sourceware.org
  53 Keep in mind glibc upstream does use Bugzilla for tracking bugs:
  54 https://sourceware.org/bugzilla/
  55
  56 == Submitting Patches
  57
  58 See the HACKING document (and additionally, the
  59 {SubmittingPatches}[https://git.kernel.org/cgit/git/git.git/tree/Documentation/SubmittingPatches]
  60 document distributed with git) on guidelines for patch submission.
  61
  62 == Contact Info
  63
  64 * public: mailto:unicorn-public@bogomips.org
  65 * private: mailto:unicorn@bogomips.org
  66
  67 We operate a {public-inbox}[http://public-inbox.org/] which
  68 feeds the mailing list.  You may subscribe either using
  69 {ssoma}[http://ssoma.public-inbox.org/] or by sending a mail
  70 to mailto:unicorn-public+subscribe@bogomips.org
  71
  72 ssoma is a mail archiver/fetcher using git.  It operates in a similar
  73 fashion to tools such as slrnpull, fetchmail, or getmail.  ssoma
  74 subscription instructions:
  75
  76         URL=git://bogomips.org/unicorn-public
  77         LISTNAME=unicorn
  78
  79         # to initialize a maildir (this may be a new or existing maildir,
  80         # ssoma will not touch existing messages)
  81         # If you prefer mbox, use mbox:/path/to/mbox as the last argument
  82         # You may also use imap://$MAILSERVER/INBOX for an IMAP account
  83         # or imaps:// for an IMAPS account, as well.
  84         ssoma add $LISTNAME $URL maildir:/path/to/maildir
  85
  86         # read with your favorite MUA (only using mutt as an example)
  87         mutt -f /path/to/maildir # (or /path/to/mbox)
  88
  89         # to keep your mbox or maildir up-to-date, periodically run the following:
  90         ssoma sync $LISTNAME
  91
  92         # your MUA may modify and delete messages from the maildir or mbox,
  93         # this does not affect ssoma functionality at all
  94
  95         # to sync all your ssoma subscriptions
  96         ssoma sync
  97
  98         # You may wish to sync in your cronjob
  99         ssoma sync --cron
 100
 101 HTML archives are available here: http://bogomips.org/unicorn-public/