summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorErnestas Kulik <ernestask@gnome.org>2017-03-21 18:55:37 +0200
committerErnestas Kulik <ernestask@gnome.org>2017-03-22 17:18:29 +0200
commit857a90c29b6a91dcad4af4134fb1bc29a5897e31 (patch)
treeba58f5b600b7c37ab933dff6ff03d37a31bd0709 /docs
parent033378c418b32af5280f855b206a34bf0a3e148a (diff)
downloadnautilus-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.am23
-rw-r--r--docs/Overview.md26
-rw-r--r--docs/reference/Makefile.am1
-rw-r--r--docs/reference/libnautilus-extension/Makefile.am78
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