diff --git a/doc/pacman.8.asciidoc b/doc/pacman.8.asciidoc
index e880e054..c77a1e7c 100644
--- a/doc/pacman.8.asciidoc
+++ b/doc/pacman.8.asciidoc
@@ -261,6 +261,12 @@ Upgrade Options (apply to '-S' and '-U')[[UO]]
 	as explicitly installed so it will not be removed by the '\--recursive'
 	remove operation.
 
+*\--note*::
+	Add an install note to packages. This will only apply to targets explicitly
+	listed and not their dependencies. The note can be used to keep track of why
+	a package was installed or any other info of note. The note can later be
+	edited or removed with '\--D \--note' or '\--D \--rmnote' respectively.
+
 *\--ignore* <package>::
 	Directs pacman to ignore upgrades of package even if there is one
 	available. Multiple packages can be specified by separating them
@@ -471,6 +477,13 @@ Database Options (apply to '-D')[[QO]]
 	package installed even when it was initially installed as a dependency
 	of another package.
 
+*\--note*::
+	Add or edit a package's install note. The note can be used to keep track of why
+	a package was installed or any other info of note.
+
+*\--rmnote*::
+	Remove a package's install note.
+
 *-k, \--check*::
 	Check the local package database is internally consistent. This will
 	check all required files are present and that installed packages have
diff --git a/lib/libalpm/add.c b/lib/libalpm/add.c
index f806e5b2..b733a735 100644
--- a/lib/libalpm/add.c
+++ b/lib/libalpm/add.c
@@ -431,8 +431,22 @@ static int commit_single_pkg(alpm_handle_t *handle, alpm_pkg_t *newpkg,
 
 	ASSERT(trans != NULL, return -1);
 
+
+	if(_alpm_db_get_pkgfromcache(db, newpkg->name)) {
+			oldpkg = newpkg->oldpkg;
+	}
+
+	/* set note on package only if it was explicitly added to transaction */
+	if(trans->note && newpkg->reason == ALPM_PKG_REASON_EXPLICIT) {
+		STRDUP(newpkg->note, trans->note,
+				RET_ERR(handle, ALPM_ERR_MEMORY, -1));
+	} else if(oldpkg && oldpkg->note) {
+		STRDUP(newpkg->note,oldpkg->note,
+				RET_ERR(handle, ALPM_ERR_MEMORY, -1));
+	}
+
+	if(oldpkg) {
 	/* see if this is an upgrade. if so, remove the old package first */
-	if(_alpm_db_get_pkgfromcache(db, newpkg->name) && (oldpkg = newpkg->oldpkg)) {
 		int cmp = _alpm_pkg_compare_versions(newpkg, oldpkg);
 		if(cmp < 0) {
 			log_msg = "downgrading";
diff --git a/lib/libalpm/alpm.h b/lib/libalpm/alpm.h
index 1376be2b..8922905f 100644
--- a/lib/libalpm/alpm.h
+++ b/lib/libalpm/alpm.h
@@ -2473,6 +2473,12 @@ const char *alpm_pkg_get_desc(alpm_pkg_t *pkg);
  */
 const char *alpm_pkg_get_url(alpm_pkg_t *pkg);
 
+/** Returns the package note.
+ * @param pkg a pointer to package
+ * @return a reference to an internal string
+ */
+char *alpm_pkg_get_note(alpm_pkg_t *pkg);
+
 /** Returns the build timestamp of the package.
  * @param pkg a pointer to package
  * @return the timestamp of the build time
@@ -2651,6 +2657,15 @@ off_t alpm_pkg_download_size(alpm_pkg_t *newpkg);
  */
 int alpm_pkg_set_reason(alpm_pkg_t *pkg, alpm_pkgreason_t reason);
 
+/** Set install note for a package in the local database.
+ * The provided package object must be from the local database or this method
+ * will fail. The write to the local database is performed immediately.
+ * @param pkg the package to edit
+ * @param note the new install note, null to remove a note
+ * @return 0 on success, -1 on error (pm_errno is set accordingly)
+ */
+int alpm_pkg_set_note(alpm_pkg_t *pkg, char *note);
+
 
 /* End of libalpm_pkg_t accessors */
 /** @} */
@@ -2800,6 +2815,16 @@ alpm_list_t *alpm_trans_get_add(alpm_handle_t *handle);
  */
 alpm_list_t *alpm_trans_get_remove(alpm_handle_t *handle);
 
+/** Sets the install note for a transaction
+ *
+ * All target packages will gain the note, dependencies will not.
+ *
+ * @param handle the context handle
+ * @note the the note, may not contain new lines
+ * @return 0 on success, -1 on error (pm_errno is set accordingly)
+ */
+int alpm_trans_set_note(alpm_handle_t *handle, char *note);
+
 /** Initialize the transaction.
  * @param handle the context handle
  * @param flags flags of the transaction (like nodeps, etc; see alpm_transflag_t)
diff --git a/lib/libalpm/be_local.c b/lib/libalpm/be_local.c
index 3f40d2e9..8b994d6a 100644
--- a/lib/libalpm/be_local.c
+++ b/lib/libalpm/be_local.c
@@ -81,6 +81,12 @@ static const char *_cache_get_url(alpm_pkg_t *pkg)
 	return pkg->url;
 }
 
+static char *_cache_get_note(alpm_pkg_t *pkg)
+{
+	LAZY_LOAD(INFRQ_DESC);
+	return pkg->note;
+}
+
 static alpm_time_t _cache_get_builddate(alpm_pkg_t *pkg)
 {
 	LAZY_LOAD(INFRQ_DESC);
@@ -330,6 +336,7 @@ static const struct pkg_operations local_pkg_ops = {
 	.get_base = _cache_get_base,
 	.get_desc = _cache_get_desc,
 	.get_url = _cache_get_url,
+	.get_note = _cache_get_note,
 	.get_builddate = _cache_get_builddate,
 	.get_installdate = _cache_get_installdate,
 	.get_packager = _cache_get_packager,
@@ -752,6 +759,8 @@ static int local_db_read(alpm_pkg_t *info, int inforeq)
 				READ_AND_STORE_ALL(info->groups);
 			} else if(strcmp(line, "%URL%") == 0) {
 				READ_AND_STORE(info->url);
+			} else if(strcmp(line, "%NOTE%") == 0) {
+				READ_AND_STORE(info->note);
 			} else if(strcmp(line, "%LICENSE%") == 0) {
 				READ_AND_STORE_ALL(info->licenses);
 			} else if(strcmp(line, "%ARCH%") == 0) {
@@ -1040,6 +1049,11 @@ int _alpm_local_db_write(alpm_db_t *db, alpm_pkg_t *info, int inforeq)
 		write_deps(fp, "%CONFLICTS%", info->conflicts);
 		write_deps(fp, "%PROVIDES%", info->provides);
 
+		if(info->note) {
+			fprintf(fp, "%%NOTE%%\n"
+							"%s\n\n", info->note);
+		}
+
 		fclose(fp);
 		fp = NULL;
 	}
@@ -1158,6 +1172,31 @@ int SYMEXPORT alpm_pkg_set_reason(alpm_pkg_t *pkg, alpm_pkgreason_t reason)
 	return 0;
 }
 
+int SYMEXPORT alpm_pkg_set_note(alpm_pkg_t *pkg, char *note)
+{
+	ASSERT(pkg != NULL, return -1);
+	ASSERT(pkg->origin == ALPM_PKG_FROM_LOCALDB,
+			RET_ERR(pkg->handle, ALPM_ERR_WRONG_ARGS, -1));
+	ASSERT(pkg->origin_data.db == pkg->handle->db_local,
+			RET_ERR(pkg->handle, ALPM_ERR_WRONG_ARGS, -1));
+
+	_alpm_log(pkg->handle, ALPM_LOG_DEBUG,
+			"setting note for %s: %s\n", pkg->name, note);
+	LAZY_LOAD(INFRQ_DESC);
+	FREE(pkg->note);
+	if(note) {
+		ASSERT(!strchr(note, '\n'), RET_ERR(pkg->handle, ALPM_ERR_WRONG_ARGS, -1));
+		STRDUP(pkg->note, note,
+				RET_ERR(pkg->handle, ALPM_ERR_MEMORY, -1));
+	}
+	/* write DESC */
+	if(_alpm_local_db_write(pkg->handle->db_local, pkg, INFRQ_DESC)) {
+		RET_ERR(pkg->handle, ALPM_ERR_DB_WRITE, -1);
+	}
+
+	return 0;
+}
+
 static const struct db_operations local_db_ops = {
 	.validate         = local_db_validate,
 	.populate         = local_db_populate,
diff --git a/lib/libalpm/db.c b/lib/libalpm/db.c
index b8d1b157..ab907568 100644
--- a/lib/libalpm/db.c
+++ b/lib/libalpm/db.c
@@ -405,6 +405,7 @@ int _alpm_db_search(alpm_db_t *db, const alpm_list_t *needles,
 			const char *matched = NULL;
 			const char *name = pkg->name;
 			const char *desc = alpm_pkg_get_desc(pkg);
+			const char *note = alpm_pkg_get_note(pkg);
 
 			/* check name as regex AND as plain text */
 			if(name && (regexec(&reg, name, 0, 0, 0) == 0 || strstr(name, targ))) {
@@ -414,6 +415,11 @@ int _alpm_db_search(alpm_db_t *db, const alpm_list_t *needles,
 			else if(desc && regexec(&reg, desc, 0, 0, 0) == 0) {
 				matched = desc;
 			}
+			/* check note */
+			else if(note && regexec(&reg, note, 0, 0, 0) == 0) {
+				matched = note;
+			}
+
 			/* TODO: should we be doing this, and should we print something
 			 * differently when we do match it since it isn't currently printed? */
 			if(!matched) {
diff --git a/lib/libalpm/package.c b/lib/libalpm/package.c
index 8302344c..95991608 100644
--- a/lib/libalpm/package.c
+++ b/lib/libalpm/package.c
@@ -78,6 +78,7 @@ int SYMEXPORT alpm_pkg_checkmd5sum(alpm_pkg_t *pkg)
 static const char *_pkg_get_base(alpm_pkg_t *pkg)        { return pkg->base; }
 static const char *_pkg_get_desc(alpm_pkg_t *pkg)        { return pkg->desc; }
 static const char *_pkg_get_url(alpm_pkg_t *pkg)         { return pkg->url; }
+static char *_pkg_get_note(alpm_pkg_t *pkg)        { return pkg->note; }
 static alpm_time_t _pkg_get_builddate(alpm_pkg_t *pkg)   { return pkg->builddate; }
 static alpm_time_t _pkg_get_installdate(alpm_pkg_t *pkg) { return pkg->installdate; }
 static const char *_pkg_get_packager(alpm_pkg_t *pkg)    { return pkg->packager; }
@@ -143,6 +144,7 @@ const struct pkg_operations default_pkg_ops = {
 	.get_base        = _pkg_get_base,
 	.get_desc        = _pkg_get_desc,
 	.get_url         = _pkg_get_url,
+	.get_note        = _pkg_get_note,
 	.get_builddate   = _pkg_get_builddate,
 	.get_installdate = _pkg_get_installdate,
 	.get_packager    = _pkg_get_packager,
@@ -227,6 +229,13 @@ const char SYMEXPORT *alpm_pkg_get_url(alpm_pkg_t *pkg)
 	return pkg->ops->get_url(pkg);
 }
 
+char SYMEXPORT *alpm_pkg_get_note(alpm_pkg_t *pkg)
+{
+	ASSERT(pkg != NULL, return NULL);
+	pkg->handle->pm_errno = ALPM_ERR_OK;
+	return pkg->ops->get_note(pkg);
+}
+
 alpm_time_t SYMEXPORT alpm_pkg_get_builddate(alpm_pkg_t *pkg)
 {
 	ASSERT(pkg != NULL, return -1);
@@ -611,6 +620,7 @@ int _alpm_pkg_dup(alpm_pkg_t *pkg, alpm_pkg_t **new_ptr)
 	STRDUP(newpkg->version, pkg->version, goto cleanup);
 	STRDUP(newpkg->desc, pkg->desc, goto cleanup);
 	STRDUP(newpkg->url, pkg->url, goto cleanup);
+	STRDUP(newpkg->note, pkg->note, goto cleanup);
 	newpkg->builddate = pkg->builddate;
 	newpkg->installdate = pkg->installdate;
 	STRDUP(newpkg->packager, pkg->packager, goto cleanup);
@@ -684,6 +694,7 @@ void _alpm_pkg_free(alpm_pkg_t *pkg)
 	FREE(pkg->version);
 	FREE(pkg->desc);
 	FREE(pkg->url);
+	FREE(pkg->note);
 	FREE(pkg->packager);
 	FREE(pkg->md5sum);
 	FREE(pkg->sha256sum);
diff --git a/lib/libalpm/package.h b/lib/libalpm/package.h
index 3332bbb3..f500d72a 100644
--- a/lib/libalpm/package.h
+++ b/lib/libalpm/package.h
@@ -46,6 +46,7 @@ struct pkg_operations {
 	const char *(*get_base) (alpm_pkg_t *);
 	const char *(*get_desc) (alpm_pkg_t *);
 	const char *(*get_url) (alpm_pkg_t *);
+	char *(*get_note) (alpm_pkg_t *);
 	alpm_time_t (*get_builddate) (alpm_pkg_t *);
 	alpm_time_t (*get_installdate) (alpm_pkg_t *);
 	const char *(*get_packager) (alpm_pkg_t *);
@@ -93,6 +94,7 @@ struct _alpm_pkg_t {
 	char *version;
 	char *desc;
 	char *url;
+	char *note;
 	char *packager;
 	char *md5sum;
 	char *sha256sum;
diff --git a/lib/libalpm/trans.c b/lib/libalpm/trans.c
index 82181d1b..22b372c9 100644
--- a/lib/libalpm/trans.c
+++ b/lib/libalpm/trans.c
@@ -299,6 +299,7 @@ void _alpm_trans_free(alpm_trans_t *trans)
 	alpm_list_free(trans->add);
 	alpm_list_free_inner(trans->remove, (alpm_list_fn_free)_alpm_pkg_free);
 	alpm_list_free(trans->remove);
+	FREE(trans->note);
 
 	FREELIST(trans->skip_remove);
 
@@ -451,3 +452,19 @@ alpm_list_t SYMEXPORT *alpm_trans_get_remove(alpm_handle_t *handle)
 
 	return handle->trans->remove;
 }
+
+int SYMEXPORT alpm_trans_set_note(alpm_handle_t *handle, char *note) {
+	CHECK_HANDLE(handle, return -1);
+	ASSERT(handle->trans != NULL, RET_ERR(handle, ALPM_ERR_TRANS_NULL, -1));
+	ASSERT(handle->trans->state == STATE_INITIALIZED, RET_ERR(handle, ALPM_ERR_TRANS_NOT_INITIALIZED, -1));
+
+	if(handle->trans->note) {
+		ASSERT(!strchr(handle->trans->note, '\n'), RET_ERR(handle, ALPM_ERR_WRONG_ARGS, -1));
+		free(handle->trans->note);
+		handle->trans->note = NULL;
+	}
+
+	STRDUP(handle->trans->note, note, RET_ERR(handle, ALPM_ERR_MEMORY, -1));
+	return 0;
+}
+
diff --git a/lib/libalpm/trans.h b/lib/libalpm/trans.h
index d2ec0223..fe38f054 100644
--- a/lib/libalpm/trans.h
+++ b/lib/libalpm/trans.h
@@ -39,6 +39,7 @@ typedef enum _alpm_transstate_t {
 typedef struct _alpm_trans_t {
 	/* bitfield of alpm_transflag_t flags */
 	int flags;
+	char *note;
 	alpm_transstate_t state;
 	alpm_list_t *unresolvable;  /* list of (alpm_pkg_t *) */
 	alpm_list_t *add;           /* list of (alpm_pkg_t *) */
diff --git a/src/pacman/conf.c b/src/pacman/conf.c
index 12fee64c..acf9ca71 100644
--- a/src/pacman/conf.c
+++ b/src/pacman/conf.c
@@ -155,6 +155,7 @@ int config_free(config_t *oldconfig)
 	free(oldconfig->dbpath);
 	free(oldconfig->logfile);
 	free(oldconfig->gpgdir);
+	free(oldconfig->note);
 	FREELIST(oldconfig->hookdirs);
 	FREELIST(oldconfig->cachedirs);
 	free(oldconfig->xfercommand);
diff --git a/src/pacman/conf.h b/src/pacman/conf.h
index aa10e3a6..ec9caa32 100644
--- a/src/pacman/conf.h
+++ b/src/pacman/conf.h
@@ -99,6 +99,8 @@ typedef struct __config_t {
 	unsigned int ask;
 	/* Bitfield of alpm_transflag_t */
 	int flags;
+	char *note;
+	int rmnote;
 	/* Bitfields of alpm_siglevel_t */
 	int siglevel;
 	int localfilesiglevel;
@@ -171,6 +173,8 @@ enum {
 	OP_NEEDED,
 	OP_NOKEEP,
 	OP_ASEXPLICIT,
+	OP_NOTE,
+	OP_RMNOTE,
 	OP_ARCH,
 	OP_PRINTFORMAT,
 	OP_GPGDIR,
diff --git a/src/pacman/database.c b/src/pacman/database.c
index 17a9c273..340f3a56 100644
--- a/src/pacman/database.c
+++ b/src/pacman/database.c
@@ -38,11 +38,12 @@
  *
  * @return 0 on success, 1 on failure
  */
-static int change_install_reason(alpm_list_t *targets)
+static int change_pkg(alpm_list_t *targets)
 {
 	alpm_list_t *i;
 	alpm_db_t *db_local;
 	int ret = 0;
+	int set_reason = 0;
 
 	alpm_pkgreason_t reason;
 
@@ -53,11 +54,10 @@ static int change_install_reason(alpm_list_t *targets)
 
 	if(config->flags & ALPM_TRANS_FLAG_ALLDEPS) { /* --asdeps */
 		reason = ALPM_PKG_REASON_DEPEND;
+		set_reason = 1;
 	} else if(config->flags & ALPM_TRANS_FLAG_ALLEXPLICIT) { /* --asexplicit */
 		reason = ALPM_PKG_REASON_EXPLICIT;
-	} else {
-		pm_printf(ALPM_LOG_ERROR, _("no install reason specified (use -h for help)\n"));
-		return 1;
+		set_reason = 1;
 	}
 
 	/* Lock database */
@@ -69,19 +69,46 @@ static int change_install_reason(alpm_list_t *targets)
 	for(i = targets; i; i = alpm_list_next(i)) {
 		char *pkgname = i->data;
 		alpm_pkg_t *pkg = alpm_db_get_pkg(db_local, pkgname);
-		if(!pkg || alpm_pkg_set_reason(pkg, reason)) {
-			pm_printf(ALPM_LOG_ERROR, _("could not set install reason for package %s (%s)\n"),
-							pkgname, alpm_strerror(alpm_errno(config->handle)));
+
+		if(!pkg) {
+			pm_printf(ALPM_LOG_ERROR, _("package '%s' was not found"), pkgname);
 			ret = 1;
-		} else {
-			if(!config->quiet) {
-				if(reason == ALPM_PKG_REASON_DEPEND) {
-					printf(_("%s: install reason has been set to 'installed as dependency'\n"), pkgname);
-				} else {
-					printf(_("%s: install reason has been set to 'explicitly installed'\n"), pkgname);
+			continue;
+		}
+
+		if(set_reason) {
+			if(alpm_pkg_set_reason(pkg, reason)) {
+				pm_printf(ALPM_LOG_ERROR, _("could not set install reason for package %s (%s)\n"),
+								pkgname, alpm_strerror(alpm_errno(config->handle)));
+				ret = 1;
+			} else {
+				if(!config->quiet) {
+					if(reason == ALPM_PKG_REASON_DEPEND) {
+						printf(_("%s: install reason has been set to 'installed as dependency'\n"), pkgname);
+					} else {
+						printf(_("%s: install reason has been set to 'explicitly installed'\n"), pkgname);
+					}
 				}
 			}
 		}
+
+		if(config->rmnote) {
+			if(alpm_pkg_set_note(pkg, NULL)) {
+				pm_printf(ALPM_LOG_ERROR, _("could not set install note for package %s (%s)\n"),
+								pkgname, alpm_strerror(alpm_errno(config->handle)));
+				ret = 1;
+			} else if(!config->quiet) {
+				printf(_("%s: note removed\n"), pkgname);
+			}
+		} else if(config->note) {
+			if(alpm_pkg_set_note(pkg, config->note)) {
+				pm_printf(ALPM_LOG_ERROR, _("could not set install note for package %s (%s)\n"),
+								pkgname, alpm_strerror(alpm_errno(config->handle)));
+				ret = 1;
+			} else if(!config->quiet) {
+				printf(_("%s: note set\n"), pkgname);
+			}
+		}
 	}
 
 	/* Unlock database */
@@ -296,8 +323,9 @@ int pacman_database(alpm_list_t *targets)
 		}
 	}
 
-	if(config->flags & (ALPM_TRANS_FLAG_ALLDEPS | ALPM_TRANS_FLAG_ALLEXPLICIT)) {
-		ret = change_install_reason(targets);
+	if(config->note || config->rmnote ||
+			(config->flags & (ALPM_TRANS_FLAG_ALLDEPS | ALPM_TRANS_FLAG_ALLEXPLICIT))) {
+		ret = change_pkg(targets);
 	}
 
 	return ret;
diff --git a/src/pacman/package.c b/src/pacman/package.c
index eaee3bb0..8e33d2bd 100644
--- a/src/pacman/package.c
+++ b/src/pacman/package.c
@@ -70,6 +70,7 @@ enum {
 	T_URL,
 	T_VALIDATED_BY,
 	T_VERSION,
+	T_NOTE,
 	/* the following is a sentinel and should remain in last position */
 	_T_MAX
 };
@@ -124,6 +125,7 @@ static void make_aligned_titles(void)
 	buf[T_URL] = _("URL");
 	buf[T_VALIDATED_BY] = _("Validated By");
 	buf[T_VERSION] = _("Version");
+	buf[T_NOTE] = _("Note");
 
 	for(i = 0; i < ARRAYSIZE(wbuf); i++) {
 		wlen[i] = mbstowcs(wbuf[i], buf[i], strlen(buf[i]) + 1);
@@ -301,6 +303,7 @@ void dump_pkg_full(alpm_pkg_t *pkg, int extra)
 	if(from == ALPM_PKG_FROM_LOCALDB) {
 		string_display(titles[T_INSTALL_DATE], idatestr, cols);
 		string_display(titles[T_INSTALL_REASON], reason, cols);
+		string_display(titles[T_NOTE], alpm_pkg_get_note(pkg), cols);
 	}
 	if(from == ALPM_PKG_FROM_FILE || from == ALPM_PKG_FROM_LOCALDB) {
 		string_display(titles[T_INSTALL_SCRIPT],
diff --git a/src/pacman/pacman.c b/src/pacman/pacman.c
index 0647d5bc..163bb2f1 100644
--- a/src/pacman/pacman.c
+++ b/src/pacman/pacman.c
@@ -169,6 +169,8 @@ static void usage(int op, const char * const myname)
 			printf("%s:\n", str_opt);
 			addlist(_("      --asdeps         mark packages as non-explicitly installed\n"));
 			addlist(_("      --asexplicit     mark packages as explicitly installed\n"));
+			addlist(_("      --note <note>    add or edit a packages install notes\n"));
+			addlist(_("      --rmnote         remove install note from packages\n"));
 			addlist(_("  -k, --check          test local database for validity (-kk for sync databases)\n"));
 			addlist(_("  -q, --quiet          suppress output of success messages\n"));
 		} else if(op == PM_OP_DEPTEST) {
@@ -193,6 +195,7 @@ static void usage(int op, const char * const myname)
 				          "                       overwrite conflicting files (can be used more than once)\n"));
 				addlist(_("      --asdeps         install packages as non-explicitly installed\n"));
 				addlist(_("      --asexplicit     install packages as explicitly installed\n"));
+				addlist(_("      --note <note>    add an install note to packages\n"));
 				addlist(_("      --ignore <pkg>   ignore a package upgrade (can be used more than once)\n"));
 				addlist(_("      --ignoregroup <grp>\n"
 				          "                       ignore a group upgrade (can be used more than once)\n"));
@@ -482,6 +485,12 @@ static int parsearg_database(int opt)
 		case OP_ASEXPLICIT:
 			config->flags |= ALPM_TRANS_FLAG_ALLEXPLICIT;
 			break;
+		case OP_NOTE:
+			config->note = strdup(optarg);
+			break;
+		case OP_RMNOTE:
+			config->rmnote = 1;
+			break;
 		case OP_CHECK:
 		case 'k':
 			(config->op_q_check)++;
@@ -502,7 +511,11 @@ static void checkargs_database(void)
 			&& config->flags & ALPM_TRANS_FLAG_ALLEXPLICIT,
 			"--asdeps", "--asexplicit");
 
+	invalid_opt(config->note && config->rmnote, "--note", "--rmnote");
+
 	if(config->op_q_check) {
+	invalid_opt(config->note != NULL, "--note", "--check");
+	invalid_opt(config->rmnote, "--rmnote", "--check");
 		invalid_opt(config->flags & ALPM_TRANS_FLAG_ALLDEPS,
 				"--asdeps", "--check");
 		invalid_opt(config->flags & ALPM_TRANS_FLAG_ALLEXPLICIT,
@@ -730,6 +743,9 @@ static int parsearg_upgrade(int opt)
 		case OP_ASEXPLICIT:
 			config->flags |= ALPM_TRANS_FLAG_ALLEXPLICIT;
 			break;
+		case OP_NOTE:
+			config->note = strdup(optarg);
+			break;
 		case OP_NEEDED:
 			config->flags |= ALPM_TRANS_FLAG_NEEDED;
 			break;
@@ -948,6 +964,8 @@ static int parseargs(int argc, char *argv[])
 		{"needed",     no_argument,       0, OP_NEEDED},
 		{"nokeep",     no_argument,       0, OP_NOKEEP},
 		{"asexplicit",     no_argument,   0, OP_ASEXPLICIT},
+		{"note",       required_argument, 0, OP_NOTE},
+		{"rmnote",     no_argument,       0, OP_RMNOTE},
 		{"arch",       required_argument, 0, OP_ARCH},
 		{"print-format", required_argument, 0, OP_PRINTFORMAT},
 		{"gpgdir",     required_argument, 0, OP_GPGDIR},
diff --git a/src/pacman/query.c b/src/pacman/query.c
index e3e7d844..f28c0f89 100644
--- a/src/pacman/query.c
+++ b/src/pacman/query.c
@@ -329,9 +329,15 @@ static int display(alpm_pkg_t *pkg)
 			&& !config->op_q_changelog && !config->op_q_check) {
 		if(!config->quiet) {
 			const colstr_t *colstr = &config->colstr;
+			char *note = alpm_pkg_get_note(pkg);
+
 			printf("%s%s %s%s%s", colstr->title, alpm_pkg_get_name(pkg),
 					colstr->version, alpm_pkg_get_version(pkg), colstr->nocolor);
 
+			if(note) {
+				printf(" (%s)", note);
+			}
+
 			if(config->op_q_upgrade) {
 				int usage;
 				alpm_pkg_t *newpkg = alpm_sync_get_new_version(pkg, alpm_get_syncdbs(config->handle));
diff --git a/src/pacman/util.c b/src/pacman/util.c
index 5486e7a5..cfcd618c 100644
--- a/src/pacman/util.c
+++ b/src/pacman/util.c
@@ -72,6 +72,15 @@ int trans_init(int flags, int check_valid)
 		trans_init_error();
 		return -1;
 	}
+
+	if(config->note) {
+		ret = alpm_trans_set_note(config->handle, config->note);
+		if(ret == -1) {
+			trans_init_error();
+			return -1;
+		}
+	}
+
 	return 0;
 }
 
diff --git a/test/pacman/meson.build b/test/pacman/meson.build
index ecab75b2..fd66f53e 100644
--- a/test/pacman/meson.build
+++ b/test/pacman/meson.build
@@ -9,6 +9,8 @@ pacman_tests = [
   'tests/config002.py',
   'tests/database001.py',
   'tests/database002.py',
+  'tests/database003.py',
+  'tests/database004.py',
   'tests/database010.py',
   'tests/database011.py',
   'tests/database012.py',
@@ -174,6 +176,7 @@ pacman_tests = [
   'tests/symlink020.py',
   'tests/symlink021.py',
   'tests/sync-failover-404-with-body.py',
+  'tests/sync-keep-note.py',
   'tests/sync-install-assumeinstalled.py',
   'tests/sync-nodepversion01.py',
   'tests/sync-nodepversion02.py',
@@ -181,6 +184,7 @@ pacman_tests = [
   'tests/sync-nodepversion04.py',
   'tests/sync-nodepversion05.py',
   'tests/sync-nodepversion06.py',
+  'tests/sync-note-targets-only.py',
   'tests/sync-sysupgrade-print-replaced-packages.py',
   'tests/sync-update-assumeinstalled.py',
   'tests/sync-update-package-removing-required-provides.py',
diff --git a/test/pacman/pmdb.py b/test/pacman/pmdb.py
index 42e032ee..fc4c6ed3 100644
--- a/test/pacman/pmdb.py
+++ b/test/pacman/pmdb.py
@@ -121,6 +121,8 @@ class pmdb(object):
                 pkg.groups = _getsection(fd)
             elif line == "%URL%":
                 pkg.url = fd.readline().strip("\n")
+            elif line == "%NOTE%":
+                pkg.note = fd.readline().strip("\n")
             elif line == "%LICENSE%":
                 pkg.license = _getsection(fd)
             elif line == "%ARCH%":
@@ -208,6 +210,7 @@ class pmdb(object):
             make_section(data, "INSTALLDATE", pkg.installdate)
             make_section(data, "SIZE", pkg.size)
             make_section(data, "REASON", pkg.reason)
+            make_section(data, "NOTE", pkg.note)
         else:
             make_section(data, "FILENAME", pkg.filename())
             make_section(data, "REPLACES", pkg.replaces)
diff --git a/test/pacman/pmpkg.py b/test/pacman/pmpkg.py
index 01ed4e0a..d893e5e2 100644
--- a/test/pacman/pmpkg.py
+++ b/test/pacman/pmpkg.py
@@ -34,6 +34,7 @@ class pmpkg(object):
         self.desc = ""
         self.groups = []
         self.url = ""
+        self.note = ""
         self.license = []
         self.arch = ""
         self.builddate = ""
@@ -71,6 +72,7 @@ class pmpkg(object):
         s.append("url: %s" % self.url)
         s.append("files: %s" % " ".join(self.files))
         s.append("reason: %d" % self.reason)
+        s.append("note: %s" % self.note)
         return "\n".join(s)
 
     def fullname(self):
diff --git a/test/pacman/pmrule.py b/test/pacman/pmrule.py
index 62fb64dd..9204a0b9 100644
--- a/test/pacman/pmrule.py
+++ b/test/pacman/pmrule.py
@@ -108,6 +108,9 @@ class pmrule(object):
                         if f.startswith(value + "\t"):
                             success = 1
                             break;
+                elif case == "NOTE":
+                    if newpkg.note != value:
+                        success = 0
                 else:
                     tap.diag("PKG rule '%s' not found" % case)
                     success = -1
diff --git a/test/pacman/pmtest.py b/test/pacman/pmtest.py
index 94b0930f..354c084a 100644
--- a/test/pacman/pmtest.py
+++ b/test/pacman/pmtest.py
@@ -322,7 +322,7 @@ class pmtest(object):
                 self.result["success"] += 1
             else:
                 self.result["fail"] += 1
-            tap.ok(success, i)
+            tap.ok(success == 1, i)
 
     def configfile(self):
         return os.path.join(self.root, util.PACCONF)
diff --git a/test/pacman/tests/database003.py b/test/pacman/tests/database003.py
new file mode 100644
index 00000000..a1ef8dc0
--- /dev/null
+++ b/test/pacman/tests/database003.py
@@ -0,0 +1,10 @@
+self.description = "-D --note :D"
+
+lp = pmpkg("pkg")
+self.addpkg2db("local", lp)
+
+self.args = "-D pkg --note :D"
+
+self.addrule("PACMAN_RETCODE=0")
+self.addrule("PKG_EXIST=pkg")
+self.addrule("PKG_NOTE=pkg|:D")
diff --git a/test/pacman/tests/database004.py b/test/pacman/tests/database004.py
new file mode 100644
index 00000000..8ea43ed6
--- /dev/null
+++ b/test/pacman/tests/database004.py
@@ -0,0 +1,11 @@
+self.description = "-D --rmnote"
+
+lp = pmpkg("pkg")
+lp.note = "D:"
+self.addpkg2db("local", lp)
+
+self.args = "-D pkg --rmnote"
+
+self.addrule("PACMAN_RETCODE=0")
+self.addrule("PKG_EXIST=pkg")
+self.addrule("PKG_NOTE=pkg|")
diff --git a/test/pacman/tests/sync-keep-note.py b/test/pacman/tests/sync-keep-note.py
new file mode 100644
index 00000000..6be4fe58
--- /dev/null
+++ b/test/pacman/tests/sync-keep-note.py
@@ -0,0 +1,14 @@
+self.description = "Sync a package keeping the existing note"
+
+sp = pmpkg("pkg")
+self.addpkg2db("sync", sp)
+
+lp = pmpkg("pkg")
+lp.note = "this is a note"
+self.addpkg2db("local", lp)
+
+self.args = "-S pkg"
+
+self.addrule("PACMAN_RETCODE=0")
+self.addrule("PKG_EXIST=pkg")
+self.addrule("PKG_NOTE=pkg|this is a note")
diff --git a/test/pacman/tests/sync-note-targets-only.py b/test/pacman/tests/sync-note-targets-only.py
new file mode 100644
index 00000000..d3d3ab9f
--- /dev/null
+++ b/test/pacman/tests/sync-note-targets-only.py
@@ -0,0 +1,30 @@
+self.description = "Make sure note is only set for targets"
+
+sp1 = pmpkg("pkg1", "1.0-2")
+sp1.depends = ["pkg2"]
+
+sp2 = pmpkg("pkg2")
+
+sp3 = pmpkg("pkg3")
+sp3.depends = ["pkg4"]
+
+sp4 = pmpkg("pkg4")
+
+for p in sp1, sp2, sp3, sp4:
+	self.addpkg2db("sync", p)
+
+lp1 = pmpkg("pkg1")
+self.addpkg2db("local", lp1)
+
+self.args = "-S pkg1 pkg3 --note aaaa"
+
+self.addrule("PACMAN_RETCODE=0")
+self.addrule("PKG_EXIST=pkg1")
+self.addrule("PKG_EXIST=pkg2")
+self.addrule("PKG_EXIST=pkg3")
+self.addrule("PKG_EXIST=pkg4")
+
+self.addrule("PKG_NOTE=pkg1|aaaa")
+self.addrule("PKG_NOTE=pkg2|")
+self.addrule("PKG_NOTE=pkg3|aaaa")
+self.addrule("PKG_NOTE=pkg4|")