diff options
author | Ernestas Kulik <ernestask@gnome.org> | 2017-03-21 18:55:37 +0200 |
---|---|---|
committer | Ernestas Kulik <ernestask@gnome.org> | 2017-03-22 17:18:29 +0200 |
commit | 857a90c29b6a91dcad4af4134fb1bc29a5897e31 (patch) | |
tree | ba58f5b600b7c37ab933dff6ff03d37a31bd0709 /docs | |
parent | 033378c418b32af5280f855b206a34bf0a3e148a (diff) | |
download | nautilus-857a90c29b6a91dcad4af4134fb1bc29a5897e31.tar.gz |
autotools: kill it
We’re moving to Meson this cycle, so this is losing some deadweight.
https://bugzilla.gnome.org/show_bug.cgi?id=780366
Diffstat (limited to 'docs')
-rw-r--r-- | docs/Makefile.am | 23 | ||||
-rw-r--r-- | docs/Overview.md | 26 | ||||
-rw-r--r-- | docs/reference/Makefile.am | 1 | ||||
-rw-r--r-- | docs/reference/libnautilus-extension/Makefile.am | 78 |
4 files changed, 26 insertions, 102 deletions
diff --git a/docs/Makefile.am b/docs/Makefile.am deleted file mode 100644 index 1a3bbd5ba..000000000 --- a/docs/Makefile.am +++ /dev/null @@ -1,23 +0,0 @@ -NULL = - -SUBDIRS = reference - -man_MANS = \ - nautilus.1 \ - $(NULL) - -EXTRA_DIST = \ - $(man_MANS) \ - architecture.txt \ - dnd.txt \ - load-states.dia \ - nautilus-internals.sxw \ - nautilus-internals.pdf \ - nautilus-io.txt \ - nautilus.faq \ - recommended-books.html \ - smoketests.html \ - state-machines.txt \ - style-guide.html \ - key_mouse_navigation.txt \ - $(NULL) diff --git a/docs/Overview.md b/docs/Overview.md new file mode 100644 index 000000000..a4d42060a --- /dev/null +++ b/docs/Overview.md @@ -0,0 +1,26 @@ += File Ownership = +In the minimal case, a nautilus file is owned by: +- Window slot -> viewed_file +- Window slot -> history list using bookmarks +- Path bar -> button -> file +- Path bar -> button -> nautilus_drag_slot_proxy + +When a file is a bookmark, nautilus application keeps a list with them, so it +also owns those files. + +Window slot is the creator of the file if the file was already not present due +to be a bookmark. + += Directory Ownership = +Every file has a directory associated, that is usually the parent. However, when +the file is a root and has no parent, the file is called self_owned, and the directory +and the file are the same location, but diferent objects. + +It's better to always deal with files instead of directories, and let the file handle +the ownership of its associated directory. + += View Ownership = +It's owned by: +- Window slot as a strong reference, since the view sinks the floating reference. +So to freed it the window slot needs to destroy it with gtk_widget_destroy () +since it's the container, but also needs to unref it. diff --git a/docs/reference/Makefile.am b/docs/reference/Makefile.am deleted file mode 100644 index fd642edea..000000000 --- a/docs/reference/Makefile.am +++ /dev/null @@ -1 +0,0 @@ -SUBDIRS = libnautilus-extension diff --git a/docs/reference/libnautilus-extension/Makefile.am b/docs/reference/libnautilus-extension/Makefile.am deleted file mode 100644 index c321908ba..000000000 --- a/docs/reference/libnautilus-extension/Makefile.am +++ /dev/null @@ -1,78 +0,0 @@ -## Process this file with automake to produce Makefile.in - -# We require automake 1.6 at least. -AUTOMAKE_OPTIONS = 1.6 - -# The name of the module, e.g. 'glib'. -DOC_MODULE=libnautilus-extension - -# The top-level SGML file. -DOC_MAIN_SGML_FILE=$(DOC_MODULE)-docs.xml - -SCAN_OPTIONS=--rebuild-types - -# The directory containing the source code. Relative to $(srcdir). -# gtk-doc will search all .c & .h files beneath here for inline comments -# documenting the functions and macros. -# e.g. DOC_SOURCE_DIR=../../../libnautilus-extension -DOC_SOURCE_DIR=$(top_srcdir)/libnautilus-extension - -# Extra options to supply to gtkdoc-mkdb. -MKDB_OPTIONS=--sgml-mode --output-format=xml - -# Extra options to supply to gtkdoc-mktmpl -# e.g. MKTMPL_OPTIONS=--only-section-tmpl -MKTMPL_OPTIONS= - -# Extra options to supply to gtkdoc-fixref. Not normally needed. -# e.g. FIXXREF_OPTIONS=--extra-dir=../gdk-pixbuf/html --extra-dir=../gdk/html -FIXXREF_OPTIONS= - -# Used for dependencies. The docs will be rebuilt if any of these change. -HFILE_GLOB=$(top_srcdir)/libnautilus-extension/*.h -CFILE_GLOB=$(top_srcdir)/libnautilus-extension/*.c - -# Header files to ignore when scanning. -IGNORE_HFILES = \ - nautilus-extension-private.h \ - $(NULL) - -# Images to copy into HTML directory -HTML_IMAGES = - -content_files = \ - version.xml \ - $(NULL) - -# SGML files where gtk-doc abbrevations (#GtkWidget) are expanded -# These files must be listed here *and* in content_files -# e.g. expand_content_files=running.sgml -expand_content_files= \ - $(NULL) - -# CFLAGS and LDFLAGS for compiling gtkdoc-scangobj with your library. -# Only needed if you are using gtkdoc-scangobj to dynamically query widget -# signals and properties. -# e.g. INCLUDES=-I$(top_srcdir) -I$(top_builddir) $(GTK_DEBUG_FLAGS) -# e.g. GTKDOC_LIBS=$(top_builddir)/gtk/$(gtktargetlib) -GTKDOC_CFLAGS = \ - $(GTK_DEBUG_FLAGS) \ - -I$(srcdir) \ - -I$(top_srcdir) \ - -I$(top_srcdir)/libnautilus-extension \ - -I$(top_builddir) \ - -I$(top_builddir)/libnautilus-extension \ - $(BASE_CFLAGS) \ - $(NULL) - -GTKDOC_LIBS = \ - $(top_builddir)/libnautilus-extension/libnautilus-extension.la \ - $(BASE_LIBS) \ - $(NULL) - -# This includes the standard gtk-doc make rules, copied by gtkdocize. -include $(top_srcdir)/gtk-doc.make - -# Other files to distribute -# e.g. EXTRA_DIST += version.xml.in -EXTRA_DIST += version.xml.in |