Dev

.gitignore

@@ -1,3 +1,24 @@
-.DS_Store
-*.mode1v3
+# Xcode
+build/
+build.log
 *.pbxuser
+!default.pbxuser
+*.mode1v3
+!default.mode1v3
+*.mode2v3
+!default.mode2v3
+*.perspectivev3
+!default.perspectivev3
+*.xcworkspace
+!default.xcworkspace
+xcuserdata
+profile
+*.moved-aside
+.DS_Store
+Dependencies/GPGTools_Core
+Dependencies/Libmacgpg
+MLHeaders
+*xcuserdata/
+Dependencies/GPGTools_Core
+Dependencies/Libmacgpg
+Dependencies/DeployResources

.gitmodules

@@ -1,3 +0,0 @@
-[submodule "GPGMail/Dependencies/MacGPGME"]
-	path = GPGMail/Dependencies/MacGPGME
-	url = git://github.com/gpgmail/macgpgme.git

.tx/config

@@ -0,0 +1,40 @@
+[main]
+host = https://www.transifex.com
+lang_map = pt_BR:pt
+
+[GPGMail.general]
+file_filter = Resources/<lang>.lproj/GPGMail.strings
+source_lang = en
+source_file = Resources/en.lproj/GPGMail.strings
+type = STRINGS
+
+[GPGMail.preferences]
+file_filter = Resources/<lang>.lproj/GPGMailPreferences.strings
+source_lang = en
+source_file = Resources/en.lproj/GPGMailPreferences.strings
+type = STRINGS
+
+[GPGMail.attachment]
+file_filter = Resources/<lang>.lproj/GPGAttachment.strings
+source_lang = en
+source_file = Resources/en.lproj/GPGAttachment.strings
+type = STRINGS
+
+[GPGMail.attachmentsxib]
+file_filter = Resources/<lang>.lproj/GPGAttachments.strings
+source_lang = en
+source_file = Resources/en.lproj/GPGAttachments.strings
+type = STRINGS
+
+[GPGMail.signatureview]
+file_filter = Resources/<lang>.lproj/SignatureView.strings
+source_lang = en
+source_file = Resources/en.lproj/SignatureView.strings
+type = STRINGS
+
+[GPGMail.signatureviewxib]
+file_filter = Resources/<lang>.lproj/GPGSignatureView.strings
+source_lang = en
+source_file = Resources/en.lproj/GPGSignatureView.strings
+type = STRINGS
+

Dependencies/.gitignore

@@ -0,0 +1 @@
+#

Docs/ADVANCED PREFERENCES

@@ -0,0 +1,36 @@
+* Use PGP inline instead of PGP/MIME (EXPERIMENTAL) *
+	defaults write org.gpgtools.gpgmail UseOpenPGPInlineToSend -bool YES|NO
+
+
+* Completely disable creating snippets. *
+	The default behaviour is to generate the preview if the passphrase is in cache
+	even if snippet generation is disabled in GPGMail preferences.
+
+	This option completely disables it.
+
+	defaults write org.gpgtools.gpgmail NeverCreatePreviewSnippets -bool YES|NO
+
+
+* Set a default security method to prefer. *
+	By default OpenPGP is preferred if no better option is found.
+	Set this option to 2 to force S/MIME. 1 = OpenPGP.
+
+	defaults write org.gpgtools.gpgmail DefaultSecurityMethod -int 1|2
+
+
+* Add a mapping for a mail-address or a domain to a key. *
+	defaults write org.gpgtools.common KeyMapping -dict-add email fingerprint
+	defaults write org.gpgtools.common KeyMapping -dict-add *@domain.com fingerprint
+
+
+* Enable debug logging. This spills out a LOT of messages. *
+	defaults write org.gpgtools.common DebugLog -bool YES|NO
+
+
+* Disable or enable OpenPGP for reading messages. *
+	defaults write org.gpgtools.gpgmail UseOpenPGPForReading -bool YES|NO
+
+
+* FOR DEBUGGING ONLY: Hides all signature attachments, even if they fail to verify. *
+	defaults write org.gpgtools.gpgmail HideAllSignatureAttachments -bool YES|NO
+

Docs/BUGS

@@ -0,0 +1,4 @@
+- Uncaught Exception if GPG is not installed.
+- Uncaught Exception if no secret keys are available.
+- Uncaught Exception if no public keys are available.
+- Uncaught Exception if pinentry is missing (happens in libmacgpg)

Docs/CODING

@@ -0,0 +1,178 @@
+Every Mail.app method which is to be swizzled, has to be prefixed
+with MA (MailApp).
+
+There's a folder in Resources which is called old. This folder
+is used to diff the a modified xib with the latest xib.
+It's used for localizeXIB. 
+DON'T EVER DELETE THIS FOLDER!
+
+* Reverse Engineering *
+
+- Sometimes it's not to easy to find out what happens to an
+  object you created. In that case you can over release it,
+  using autorelease or release. This way, the object will be
+  ending up an NSZombie, which can later be tracked using Instruments
+  allocation tool. (VERY HELPFUL)
+
+- clearCachedDecrypted is called everytime the message is unlodaed.
+  we should better cache it.
+
+- Mail internally seems to use firstChildPart to determine the charset of the message.
+
+- Log all messages -> instrumentObjcMessageSends(YES) writes to  /tmp/msgSends-
+
+_getSomeCharsetFromPartTree -> exists only internally
+
+- -[Message setNumberOfAttachments:isSigned:isEncrypted:] is only called for
+  encrypted messages, strangely enough.
+  Still have to find out what usually sets the number.
+  Mail.app uses -[MessageStore setNumberOfAttachments:isSigned:isEncrypted:forMessage:] to set the number
+  of attachments for every message, but this is only called when the message comes in
+  and never touched again, except for encrypted messages.
+
+  So to always work, GPGMail forces Mail.app to update the number for every message, each time
+  it's parsed or the number is different, by recalculating the number.
+
+* Committing *
+
+- Always use git -p <filename>. This let's you decide for each file
+  what lines should be added to a commit.
+- Use this to create commits which only fix one problem at a time.
+
+* Other *
+
+- Mail.app comes with a lot of general class enhancements. It's best to look
+  them through to find helpful ones.
+
+  @interface NSData (MessageAdditions)
+  - (id)initWithDataConvertingLineEndingsFromUnixToNetwork:(id)arg1;
+  - (id)initWithDataConvertingLineEndingsFromNetworkToUnix:(id)arg1;
+  - (id)dataByConvertingLineEndingsFromUnixToNetwork;
+
+  // To detect if the data contains real message headers.
+  - (struct _NSRange)rangeOfRFC822HeaderData;
+
+* Data Detectors *
+
+- Extremely hard to implement native ones.
+- Enabling Javascript in WebViews works
+  [[WebView preferences] setJavaScriptEnabled:YES]
+- Using Javascript to emulate the bevaiour might be rather easy.
+
+* Mountain Lion *
+
+- MimePart, MimeBody and other very important classes from Message.framework
+  are now in CoreMessage.framework
+- MessageStore does no longer exist but was replaced by MessageDataSource.
+- On Mountain Lion compiled GPGMail doesn't load, where on Lion compiled GPGMail loads
+  - Check Framework dependencies.
+  - Update Header files for Mountain Lion
+
+* OpenPGP | S/MIME co-existence
+
+1.) A new message (not reply) is created check if the there's a key for signing
+    for the address in either OpenPGP or S/MIME. Choose the method to enable accordingly.
+
+    If there are keys for either method, check the entries which method was last used
+    to sign with this key.
+
+    If again both methods are found check which was used more often.
+
+    Once a user changes the method manually, NEVER automatically manipulate that
+    choice again.
+
+    [ComposeBackEnd type] defines whether the message is replied|forwared|replied-to-all|new
+        - 5 -> New message
+        - 1 -> Reply
+        - 2 -> Reply to all
+        - 3 -> Forward
+        - 4 -> Reply to already open mesage? (Mail.app was closed with this reply open and it's restored.)
+
+    once a user enters addresses a dictionary is checked to see if the last time
+    the user sent to these addresses decided to encrypt or not and sets that status. 
+    If no message was sent yet to that user, don't encrypt.
+
+    If there's one key for signing for each method but the recipients can only be found for one encryption method
+    automatically select that encryption method.
+
+    If a user replies to a message, check if the message was signed and set signed.
+    If a user replies to a message, check if the message was encrypted and set encrypted.
+    Don't set something which the old message was not.
+
+    User defaults should look like this
+    [address][sign][SMIME][addresses][did-sign] = counter
+    [address][sign][PGP][addresses][did-not-sign] = counter
+    [address][sign][addresses][last-used-method] = 'SMIME' | 'PGP'
+    [address][sign][addresses][last-status] = 'did sign' | 'did not sign'
+    [address][encrypt][SMIME][addresses][did-encrypt] = counter
+    [address][encrypt][PGP][addresses][did-not-encrypt] = counter
+    [address][encrypt][addresses][last-used-method] = 'SMIME' | 'PGP'
+    [address][encrypt][addresses][last-status] = 'did encrypt' | 'did not encrypt'
+
+* Indexing encrypted messages
+
+Message.h
+
+- (id)stringForIndexing;
+- (id)stringForIndexingUpdatingBodyFlags:(BOOL)arg1;
+
+might be relevant.
+
+* Access struct instance variables of Mail Classes *
+
+Copy the struct definition you want to use into your header file
+using a typedef. After that you can access the struct data using the following
+code.
+
+StructType structVar; 
+object_getInstanceVariable(self, "<instance-variable-name>", (void **)&structVar);
+
+Very nice!
+
+* XPC Services for sandboxed Mail.app >= 10.8 *
+
+Bad Apple which really doesn't like plugins for Mail.app has disabled mach lookup names
+for Mail.app
+Our XPC Service has to use a mach name since it's running as a launchd item instead
+as part of an app (otherwise it would have to live inside Mail.app and we certainly
+don't want to mess with that!).
+BUT fortunately for us, Apple has introduced an two exceptions for mach lookup names.
+One can be found in the file /System/Library/Sandbox/Profiles/application.sb (which contains
+the rules which are evaluated for each available entitlement) and one can be found
+in the entitlements Mail.app is signed with directly.
+Use "codesign --display --entitlements - /Applications/Mail.app" to display the available
+entitlements and check for "mach-lookup" to find interesting ones.
+In the application.sb file there's a mach-lookup allow rule, which allows every app to lookup
+mach services which end in _OpenStep.
+Mail.app's entitlements allow every mach service which only has numbers as its name.
+So as long as Apple doesn't remove these rules and our xpc service has a matching name
+we're mighty mighty fine :)!
+
+* Additional documentation for NSXPCConnection *
+
+NSXPCConnection invokes error, interruption or invalidation handlers
+for specific errors which are documented, but as not much as one would want.
+
+This is a list of all the available handlers and when they are invoked:
+
+- invalidationHandler:
+	- invoked when there's a problem establishing a connection:
+		- the xpc service was unloaded or is being unloaded while a message
+		  is waiting for a response
+		- the xpc service is not loaded at all -> in that case it's invoked
+		  immediately after calling resume.
+
+- remoteObjectProxy errorHandler:
+	- when the xpc service crashes (e.g. overrelease or other BAD EXC failure in the xpc service)
+	- when the xpc service is killed (also with -9)
+	- when the xpc service is unloaded with `launchctl unload`
+	- when the xpc service is unloaded with `launchctl remove`
+
+- interruptionHandler:
+	- when the connection was already invalidated (call to invalidate)
+	  and the xpc service is killed.
+	- everytime remoteObjectProxy errorHandler is invoked.
+
+* Class weak linking for Mavericks *
+
+http://www.sealiesoftware.com/blog/archive/2010/4/8/Do-it-yourself_Objective-C_weak_import.html

Docs/GPG related notes

@@ -0,0 +1,14 @@
+Keys and Subkeys
+
+- Each subkey is a new key pair - public key / secret key
+- To encrypt or sign a message you need at least one valid key
+- either subkey or the primary key
+- Subkey are used to build something similar to a certificate tree
+- if a node is invalidated, the nodes under it are invalidated as well.
+- not necessary to consider them in gpg mail
+- Each key has at least one subkey which is automatically created when a new key is created
+
+UIDS
+
+- Each uid is an identity for a key
+- A uid allows the key to set a different name or a different email address or similar

Docs/GPGMAIL_NOTES

@@ -0,0 +1,11 @@
+- _updateSecurityStateInBackgroundForRecipients:sender: calls inside itself
+    1.) canSignFromAddress:
+    2.) canEncryptFromAddress:
+
+
+- updateSecurityControls seems to call _updateSecurityStateInBackgroundForRecipients:sender: with
+  an NSInvocation
+
+
+ Might be interesting
+- (id)missingCertificatesMessageForRecipients:(id)arg1 uponDelivery:(BOOL)arg2;

Docs/GPGMail - signer info for header

@@ -0,0 +1,36 @@
+for signature verification
+call parentController on MessageHeaderDisplay -> receive MessageContentController
+call viewingState -> call mimeBody
+call mimeBody -> topLevelPart
+uses messageFlags to check if the message is indeed signed.
+and based on that info calls isSigned.
+and then verifySignature on that.
+
+
+verify signature steps in decodeMultipartSignedWithContext:
+-> call verifySignature
+  -> call needsSignatureVerification:(parameter is a pointer to a MFError)
+	 -> checks if _smimeError is set already, returns 0 if so
+	    and sets the error pointer on _smimeError.
+  -> if yes
+  -> call usesKnownSignatureProtocol
+  -> if yes
+  -> call signedData -> being the data that was signed (obv!)
+  -> fetch data for signature part
+  -> now, when it's gpg, the signature is not recognized as such
+     hence verifySignatureWithCMSDecoder is never called,
+     we have to do it ourselves.
+
+
+
+ -> call verifySignatureWithCMSDecoder
+	 -> if an error occurs -> set MFError on error pointer
+						   -> set _smimeError to the MFError
+	 return value seems to be always null
+
+-- on a different note, on init all message flags are set to 1
+4294967295 this is 111111111111111111111111 in binary
+-- after that, these flags are updated accordingly
+
+
+Error Domain=MFMessageErrorDomain Code=1036 "Beim Lesen der digitalen Signatur dieser E-Mail ist ein Problem aufgetreten." UserInfo=0x107f01a50 {NSLocalizedDescription=Beim Lesen der digitalen Signatur dieser E-Mail ist ein Problem aufgetreten., MFSMIMESignerStatus=4, _MFShortDescription=Die E-Mail-Signatur konnte nicht überprüft werden., MFSMIMECertificateStatus=-2147409652, MFSMIMETrustKey=<SecTrust 0x10b972ad0 [0x7fff7d45eea0]>}